Overview

 

ON THIS PAGE      Show

 

 

 

 

What is AP Media API?

For the first time, you can access all your licensed multimedia content programmatically through a simple API interface.

The API allows you to receive a continuous feed of news content or perform granular searches across archives of all media types.

 

  Tip

 

  • For tighter integration of your system with AP Media API, you can write your own custom program for processing a feed or searching and downloading content. To learn more, see AP Media API Developer documentation.

  • Alternatively, you can use AP Media Agent for automatic downloads of content available via AP Media API feeds.

 

 

 

What type of content is available via AP Media API?

Media types include text/story with linked curated content, pictures, print graphics, video and audio.

Accessing content programmatically via the API?

  • 30 days of content is available, as well as the full library of current and archive audio and print graphics content. Access will subsequently be expanded to include AP image and video archives.
  • AP Media API supports the same content as AP WebFeeds and AP Newsroom, including content available via AP Content API and AP Breaking News API; depending on your contract terms.

Using AP Media API agent?

  • Up to the last 72 hours of content is available.
  • AP Media Agent supports the same content as AP WebFeeds; depending on your contract terms.

 

  Note

 

Please refer to contract information for details and contact your AP Sales or Licensing representative with any questions.

 

 

 

What are AP Media Agent and Configuration Dashboard?

AP Media Agent and Configuration Dashboard allow you to automatically download a continuous feed of news content available through AP Media API.

AP Media Agent is a Java application for content ingestion. AP Media Agent Configuration Dashboard is the AP Newsroom module  for configuring and managing content ingest agents.

You can download content for your entitlements; for example, products, packages and AP Newsroom personal Followed Topics. Content files and metadata are saved to specified folders watched by your content management system (CMS). Get Started >>

The agent has access to content from up to the last 72 hours.

What is AP Newsroom?

AP Newsroom (newsroom.ap.org) is AP's new multimedia platform, created with input from our customers, which permits you to work "anywhere, anytime, on any device." It is story-centric and enables you to easily find not just the linked media, but also all media content related to AP stories.

AP Newsroom Followed Topics include AP Topics you are interested in and personal Followed Topics, which are user-customizable searches created in AP Newsroom, based upon criteria you select.

You can create personal Followed Topics for your favorite subjects in AP Newsroom and get content feeds for these Followed Topics via AP Media API or AP Media Agent.

 

  Note

 

Feeds can be created for personal Followed Topics only (not for AP Topics).

 

 

 

In the near future, you will also be able to select one or more On-Demand content items of interest in AP Newsroom and have the content automatically delivered to you via AP Media API or AP Media Agent.

What are entitlements?

Entitlements are AP products and packages to which your organization is entitled, personal Followed Topics created in AP Newsroom and On-Demand content items selected in AP Newsroom.

Products

A product is a standard AP news service or report, which is defined by a name, a product ID number and a description; for example, "AP Online National News."

Packages

A package is a bundle of products.

Personal Followed Topics

Personal Followed Topics are user-customizable searches created in AP Newsroom, based upon criteria you select. If you create a feed for a personal Followed Topic feed in AP Newsroom and then ingest the feed using AP Media Agent or AP Media API, any new content matching the search criteria will automatically be sent to your CMS. Learn more >>

On-Demand Content

On-Demand allows you to select either an individual story (and, if any, its linked media) or an individual media item in AP Newsroom and have the items automatically delivered via AP Media API or AP Media Agent. Learn more >>

Feed Delivery of Personal Followed Topics

Personal Followed Topics allow you to monitor incoming content for your favorite news subjects. You can create feeds for personal Followed Topics in AP Newsroom.

How do I create a personal Followed Topic?

To create a personal Followed Topic, visit newsroom.ap.org, perform a search and click Follow below the media filters.

How do I create a feed for my personal Followed Topic?

  1. In AP Newsroom, click in the Search bar and select Manage Followed Topics to display the Manage Your Followed Topics page.
  2. Make sure the Show personal topics only check box is selected.
  3. Move your mouse over the personal Followed Topic to display . Move your mouse over and select Edit personal topic to display the Followed Topic window.
  4. Enable Create Feed; then click Update.

 

  Note

 

The Create Feed option can also be enabled when you create a personal Followed Topic.

 

 

 

To learn more about Followed Topics, refer to the AP Newsroom support documentation.

How do I ingest Followed Topic feeds?

If you are using AP Media Agent

  1. On the AP Media Agent Configuration Dashboard, navigate to your desired profile.
  2. On the Select Content tab, click the Followed Topics tab and select one or more Followed Topic feeds.
  3. Click Save Profile at the bottom of the page to save your selections.

If you are accessing the content programmatically via AP Media API

Use the following request URL for the initial feed request:

https://api.ap.org/media/v/content/feed?q=followedtopicid:714600&apikey={apikey}

All subsequent feed requests must use the next_page link from the previous feed response.

In the example above, 714600 is the desired personal Followed Topic ID. To obtain the Topic ID, make sure the Show personal topics only check box is selected on AP Newsroom's Manage Your Followed Topics page and move your mouse over the personal Followed Topic:

To learn more about AP Media API feed requests, refer to the AP Media API Developer documentation.

On-Demand Content Delivery

On-Demand delivery is very flexible, allowing you to more carefully select the content to send to AP Media Agent or AP Media API.

How do I select my On-Demand content in AP Newsroom?

  1. In AP Newsroom, perform a search to locate the desired content.
  2. Click Send to On-Demand from a content item's detail view.

How do I ingest my On-Demand content?

If you are using AP Media Agent

  1. On the AP Media Agent Configuration Dashboard, navigate to your desired profile.
  2. On the Select Content tab, in the AP NewsRoom On-Demand section, select the On-Demand check box.
  3. Click Save Profile at the bottom of the page to save your selections.

If you are accessing the content programmatically via AP Media API

Use the following request URL:

https://api.ap.org/media/v/content/ondemand?apikey={apikey}

To learn more, refer to the AP Media API Developer documentation.