AP Media API 2.2 Help Center
Click here to see this page in full context
 
  1. Home  >  
  2. Media API Help Center >
  3. Reference Guide >
  4. Content Files and Feeds >
  5. Feed Delivery of Personal Topics / Saved Searches
 
 

Feed Delivery of Personal Topics / Saved Searches

 
ON THIS PAGE          HideON THIS PAGE          Show
  1. What are personal Followed Topics / saved searches?
  2. How do I create a personal topic / saved search?
  3. How do I create a feed for my personal topic / saved search?
  4. How do I ingest Followed Topic feeds?
    1. If you are using AP Media Agent
    2. If you are accessing the content programmatically via AP Media API

 

 

What are personal Followed Topics / saved searches?

In the classic AP Newsroom at newsroom.ap.org, personal Followed Topics are user-customizable searches created based upon criteria you select. You can use personal topics to monitor incoming content for your favorite news subjects. If you create a feed for a personal topic 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.

 

In the new AP Newsroom at newsroombeta.ap.org, personal Followed Topics are called "saved searches." Saved searches are custom search topics that you create to track specific keywords that may not be covered by AP’s predefined topics. Saved searches currently support only keyword search and do not reflect the inclusion of filters and additional parameters (both regular and advanced). For more information, see What's New in AP Newsroom.

 

How do I create a personal topic / saved search?

In the classic AP Newsroom:

At newsroom.ap.org, perform a search and click Follow below the media filters. For more information, see Followed Topics in the classic AP Newsroom documentation.

 

If you have access to the new AP Newsroom:

  1. At newsroombeta.ap.org, perform a search.

  2. Click Save Search () above the search results on the right:

  1. In the Saved search options window, you have the following options:

    • To change the display name of your saved search, type the new name in the Rename display name box.

    • To create a feed for your saved search, click the Create feed toggle, and then select the media types that you want to receive in the feed.

  1. Click Confirm to create the saved search and close the window. The label above the search results is updated to Saved Search ().

 

How do I create a feed for my personal topic / saved search?

These instructions explain how to create a feed for an existing personal topic / saved search. You can also create a feed when you create a new personal topic / saved search.

In the classic AP Newsroom:

  1. 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 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.

 

If you have access to the new AP Newsroom:

  1. At newsroombeta.ap.org, click (For you) at left (if you do not see it, first click the AP logo to go to the homepage):

  1. Click next to Saved Searches:

  1. In the All Saved Searches window, point to the name of the saved search for which you want to enable the feed: 

  1. Click    and then select Create feed from the menu:

  1. In the Create feed window, you can select the media types that you want to receive in the feed:

  1. Click Create feed.

 

How do I ingest Followed Topic feeds?

If you are using AP Media Agent

In the classic AP Newsroom:

  1. Click at top left and select AP Media API from the menu to display the configuration dashboard.

  2. On the configuration dashboard, navigate to your desired profile.

  3. On the Select Content tab, click the Followed Topics tab and select one or more personal Followed Topic feeds.

  4. Click Save Profile at the bottom of the page to save your selections.

 

In the new AP Newsroom at newsroombeta.ap.org, personal Followed Topics are called "saved searches."

  1. Click  at top right and then select Media API from the menu: 

  1. On the configuration dashboard, navigate to your desired profile.

  2. On the Select Content tab, click the Saved Searches tab and select one or more saved search feeds:

  1. Click Save Profile at the bottom of the page to save your selections.

 

If you are accessing the content programmatically via AP Media API

  Important

 

Make sure to supply the API key in the x-api-key request header for both requests below. 

 

 

 

  1. For your account, get a list of the personal Followed Topics / saved searches for which a feed was created in AP Newsroom:

    https://api.ap.org/media/v/account/followedtopics

    Alternatively, you can look up a topic ID / saved search ID in AP Newsroom as described below.

  2. Use the following request URL for the initial feed request:

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

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

To learn more about AP Media API feed requests, see Followed Topics / Saved Searches and Feed.

Getting the topic ID from the classic AP Newsroom

On the Manage Your Followed Topics page, make sure the Show personal topics only check box is selected and move your mouse over the personal Followed Topic to display the topic ID:

 

If you have access to the new AP Newsroom:

  1. At newsroombeta.ap.org, click (For you) at left:

  1. Below Saved Searches, click a saved search name; for example, "tennis":

  1. On the search results page for this saved search, you can find the saved search ID (ftid) in the URL; for example, 881008: 

 
 

 

 

 

 

If you still require additional assistance, please contact AP Customer Support.

For current system status or system maintenance information, please visit the AP Customer Zone website.

 

 

 
 

 

 

 

THE ASSOCIATED PRESS

© copyright 2025  Associated Press. All rights reserved.