Getting Started with AP Media API
|
|
|
|
|
If you are looking for Developer documentation, you are in the right place. |
|
|
|
|
Content Available via AP Media API
For the first time, you can access all your licensed multimedia content programmatically through a simple API.
-
Receive a continuous feed of news content or perform granular searches across archives of all media types. To learn more, see Feed or Search? and check out example API requests.
-
Media types include text/story with linked curated content, pictures, graphics, video and audio.
-
30 days of content is available, as well as the full library of current and archive picture, video, audio and graphics content.
-
Content item pricing based on your contract is returned upon request.
|
|
|
|
AP Media API supports the same content as AP Newsroom, depending on your contract terms. Please refer to contract information for details and contact your AP Sales or Licensing representative with any questions. |
|
|
|
|
NoteAPI Security Requirements
HTTPS Access
Use HTTPS with TLS 1.2 or 1.3 for all API requests to api.ap.org.
API Key in the Request Header
An API key is the access key required for making API calls.
To authorize your API request, supply the API key in the x-api-key HTTP request header. The x-apikey header is also currently supported.
Example
Request URL
https://api.ap.org/media/v/content/feed?q=productid:41664
Request Header
x-api-key: abcdef12345
No Browser-Based Integrations
|
|
|
|
The AP advises against building browser-based integrations that directly call the AP Media API. Such integrations are vulnerable to the evolving landscape of browser security policies and inherently expose more security vulnerabilities. You must integrate through your own secure middleware that aligns with best security practices and allows for better support. For these reasons, the AP is unable to support customers who choose to call Media API directly from a browser. |
|
|
|
|
ImportantAccount Quotas
API requests are subject to quotas, which limit the number of calls per minute and/or per day.
If you exceed your quota, you may experience delays in content and/or delivery disruptions. To learn more, see Staying Under Your Quota Limits.
API Explorer
The Swagger-based API Explorer is an interactive quick reference that lists the API calls and parameters and allows for testing live API calls and generating sample code.
URL Encoding
|
|
|
|
Make sure that your request URIs are URL-encoded. |
|
|
|
|
The AP Media API documentation shows unencoded request URLs for readability; however, all request URLs must be URL-encoded when you are making API calls.
Accessible Port and Site Requirements
To successfully integrate with Media API, your system must allow:
-
Bidirectional access to port 443 (HTTPS) and 80 (HTTP; not required if only HTTPS is used) for api.ap.org and mapi.associatedpress.com
-
Redirects (302) from api.ap.org to mapi.associatedpress.com
-
GET and POST access to api.ap.org