Skip to content

Getting Started

Video Tutorial

Getting Started Video
Getting Started (03:12)

Quick Steps

System Requirements

Review the system requirements for the agent and portal to check if your system is compatible or if you need to upgrade.

Log In

  1. Go to the AP Media API Portal and enter your AP Newsroom user name and password.
  2. Click Login to display the Agent Configuration Dashboard.

Create a Content Profile

  1. On the Agent Configuration Dashboard, click Create Profile, and then click New Profile.
  2. On the Create Ingest Profile page, type the name of the profile in the Profile Name box.
  3. On the Select Content tab, select the check box next to each entitlement that you want to download. Learn more >>
  4. On the Content Options tab, select the file types and formats for downloading content; for example, you can choose to download specific video renditions or NITF-formatted stories. Learn more >>
  5. On the Content Save Options tab, you can customize the directory for saving content, folder structure, file naming format and duplicate settings. Learn more >>


    The settings that you specify on the Content Options and Content Save Options tabs are the default settings for downloading content for all entitlements. You can customize these settings for each entitlement by clicking Edit Settings on the Select Content tab. Learn more >>

  6. Click Save at the bottom of the page to save your profile.

Get API Key

On the dashboard, click See My API Keys (you may need to confirm your password to display your API key).

Download and Register Agent

  1. On the dashboard, click Download Agent and save the agent jar file to a folder on your machine.


    • When choosing the folder for saving the jar file, consider that this folder will be your <Agent Directory> below which the agent will be saving files by default when you start ingesting content.
    • It is strongly recommended not to save content in any system folders.
    • It is not recommended to run the agent from your Desktop.
    • Renaming the agent jar file is not recommended.
    • If you are planning to run multiple agents on the same machine, each agent jar file must be in its own folder.
  2. Do one of the following to run the agent:

    • From your desktop environment, browse to the folder where you saved the agent jar file and double-click the file name. The Agent Registration page opens in your browser.
    • From a command prompt on Windows or with sudo on Mac or Linux:

      1. Change to the directory where the agent jar file is located; for example, on Windows:
      2. Run the following command:
        java -jar agent.jar

    The Register Agent page opens in your browser prompting you for an API key.


    Alternatively, you can provide the API key as an argument from the command prompt:

    java -jar agent.jar key:API_KEY

  3. To register your agent with the portal, enter your API key in the API Key box and click Register. If registration is successful, you will receive this message: "Success you've verified your API Key".


    Check your browser's Address box to determine where the Agent Management page is located on your local machine. For example, if your agent registration address is localhost:8087/register, you can manage your agent from your local machine at localhost:8087/agent.

  4. Click Go to Admin Portal to assign a content profile to your agent.

Assign the Profile to the Agent

  1. On the Manage Ingest Agent page, enter the agent name of your choice in the Agent Name box. The agent name allows you to identify this agent on the portal and must be unique.
  2. Select your content profile from the Content Profile list.
  3. Make sure that the default access mode and version are selected from the Access Mode lists.
  4. Click Save Agent. The agent starts ingesting content.

Start Ingesting Content

When you click Save Agent, the agent starts ingesting content right away.