Associated Press Getting Started: API Integration Guide (2026)

Getting started overview

Integrating with Associated Press (AP) APIs provides programmatic access to news content, including articles, images, and video. The process generally involves account creation, obtaining API credentials, and then constructing authenticated requests to the desired API endpoint. AP offers a 7-day free trial for developers to evaluate the APIs before committing to a paid plan.

The AP Developer Portal serves as the central hub for documentation, API references, and account management. Developers can access various APIs, such as the AP Content API for text articles, the AP Images API for visual media, and the AP Video API for multimedia content AP Developer documentation. Each API is designed to deliver specific types of journalistic assets, enabling applications to display or process real-time news.

Before making your first API call, it is recommended to review the specific API documentation for the service you intend to use, as authentication methods and endpoint structures can vary slightly between different AP APIs.

Create an account and get keys

To begin using Associated Press APIs, you must first create an account on the AP Developer Portal and obtain the necessary API keys. These keys serve as your credentials for authenticating requests and are essential for accessing any AP API.

1. Visit the AP Developer Portal: Navigate to the official Associated Press Developer Portal homepage.
2. Sign Up or Log In: If you are a new user, locate the "Sign Up" or "Get Started" option to create a new developer account. Existing users can log in with their credentials.
3. Start a Free Trial (Optional but Recommended): AP offers a 7-day free trial. This trial period allows you to test the APIs without immediate financial commitment and is typically initiated during the account creation or subscription selection process.
4. Select an API Product: Once logged in, you will typically need to subscribe to a specific API product, such as the AP Content API or AP Images API, even for the free trial.
5. Generate API Keys: After selecting a product, navigate to your dashboard or "My Apps" section. Here, you should find an option to generate or view your API keys. AP APIs often use an API key for authentication, which is a unique string of characters assigned to your application. Keep your API keys confidential, as they grant access to your account's API usage.
6. Note Your Credentials: Securely record your API key. You will need to include this key in the headers or query parameters of your API requests for authentication.

For security, API keys should be handled like passwords. Avoid embedding them directly in client-side code or public repositories. Server-side environments or secure environment variables are recommended for storing and accessing API keys Google Maps API key security recommendations.

Your first request

After obtaining your API key, you can make your first authenticated request to an Associated Press API. This example demonstrates a basic request using cURL to the AP Content API, which is commonly used to retrieve news articles. Replace YOUR_API_KEY with the actual key you generated.

This example assumes you have subscribed to the AP Content API and have a valid API key. The specific endpoint and parameters may vary depending on the AP API you are using AP API Reference documentation.

Example: Fetching recent articles (AP Content API)

curl -X GET \
  'https://api.ap.org/content/v1/articles?q=election&count=5' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'

Explanation of the cURL command:

• -X GET: Specifies the HTTP method as GET, used for retrieving data.
• 'https://api.ap.org/content/v1/articles?q=election&count=5': This is the API endpoint URL.
• /content/v1/articles: The base path for fetching articles from the Content API.
• ?q=election&count=5: Query parameters. q=election searches for articles containing "election", and count=5 limits the results to five articles.
• -H 'x-api-key: YOUR_API_KEY': Sets the x-api-key HTTP header, which is where your API key is passed for authentication.
• -H 'Accept: application/json': Specifies that the client prefers to receive the response in JSON format.

Upon successful execution, the API will return a JSON object containing an array of recent articles matching your query. The structure of the JSON response will include fields such as title, publication date, URL, and content snippets, as detailed in the AP Content API reference.

Example: Python request

Here's how you might make a similar request using Python:

import requests

api_key = 'YOUR_API_KEY'
url = 'https://api.ap.org/content/v1/articles'

headers = {
    'x-api-key': api_key,
    'Accept': 'application/json'
}

params = {
    'q': 'technology',
    'count': 3
}

try:
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()  # Raise an HTTPError for bad responses (4xx or 5xx)
    data = response.json()
    
    if data and 'articles' in data:
        for article in data['articles']:
            print(f"Title: {article.get('title')}")
            print(f"URL: {article.get('webUrl')}\n")
    else:
        print("No articles found or unexpected response format.")

except requests.exceptions.HTTPError as errh:
    print(f"HTTP Error: {errh}")
except requests.exceptions.ConnectionError as errc:
    print(f"Error Connecting: {errc}")
except requests.exceptions.Timeout as errt:
    print(f"Timeout Error: {errt}")
except requests.exceptions.RequestException as err:
    print(f"Something went wrong: {err}")

Common next steps

After successfully making your first API call, consider these common next steps to further integrate and optimize your use of Associated Press APIs:

1. Explore Other Endpoints: Review the AP API Reference for the specific API you are using. Discover other available endpoints and parameters that can provide different types of content (e.g., specific categories, date ranges, media types like images or video).
2. Implement Error Handling: Integrate robust error handling into your application. Anticipate common HTTP status codes (e.g., 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 500 Internal Server Error) and implement appropriate responses Mozilla HTTP status code documentation.
3. Manage Rate Limits: Understand and respect the rate limits imposed by the AP APIs. Exceeding these limits can result in temporary blocks or errors. Implement retry mechanisms with exponential backoff for rate-limited responses to ensure your application remains resilient.
4. Parse and Process Data: Develop logic to effectively parse and process the JSON responses from the API. Extract relevant data fields and integrate them into your application's data models or display logic.
5. Set Up Webhooks (if available): Some APIs offer webhooks for real-time notifications of new content or updates. If available for your chosen AP API, setting up webhooks can reduce the need for constant polling and improve efficiency.
6. Monitor API Usage: Utilize the AP Developer Portal dashboard to monitor your API usage, track requests, and ensure you stay within your subscription limits.
7. Consider SDKs: While AP provides examples in cURL and common languages, check if official or community-supported SDKs are available for your preferred programming language. SDKs can simplify API interaction by abstracting HTTP requests and handling authentication.
8. Upgrade Your Plan: If your free trial expires or your usage exceeds the starter tier, review the AP pricing page to select a plan that aligns with your application's needs.

Troubleshooting the first call

When making your first API call to Associated Press, you might encounter issues. Here are common problems and their solutions:

• 401 Unauthorized / Invalid API Key:

  • Problem: The API returns a 401 status code, indicating that your request is not authorized.
  • Solution: Double-check that your API key is correctly included in the x-api-key header and that there are no typos. Ensure the key you are using is active and associated with the specific API product you are trying to access. Verify that your subscription or free trial is still active.

• 403 Forbidden:

  • Problem: The server understood the request but refuses to authorize it. This can occur if your API key does not have the necessary permissions for the requested resource or if your account is suspended.
  • Solution: Confirm that your API key is authorized for the specific endpoint and data you are trying to access. Check your account status on the AP Developer Portal.

• 404 Not Found:

  • Problem: The API endpoint or resource you are trying to access does not exist.
  • Solution: Verify the API endpoint URL against the AP API Reference documentation. Ensure correct casing and spelling for all path segments and query parameters.

• 429 Too Many Requests (Rate Limit Exceeded):

  • Problem: You have sent too many requests in a given time frame.
  • Solution: Wait for a short period before retrying. For production applications, implement a rate-limiting strategy on your end, such as exponential backoff, to prevent exceeding limits. Review the AP documentation for specific rate limit details.

• CORS Issues (for client-side applications):

  • Problem: If you are making requests directly from a web browser (JavaScript), you might encounter Cross-Origin Resource Sharing (CORS) errors.
  • Solution: AP APIs are typically designed for server-side integration. If you need client-side access, consider setting up a proxy server (your own backend service) that makes the requests to the AP API and then serves the data to your client-side application. This also helps in keeping your API key secure.

• Incorrect JSON Parsing:

  • Problem: Your application receives a response but fails to parse it, or the data structure is not what you expect.
  • Solution: Print the raw API response to inspect its structure. Compare it against the AP API documentation's expected response format. Ensure your JSON parser is handling potential null values or missing fields gracefully.