Skip to content
Back to Home

Quick Reference FAQs

What are the system requirements for the AP Media API Portal? For the AP Media Agent?

See System Requirements.

What credentials should I use to log in to the AP Media API Portal?

Use your AP Newsroom credentials to log in to the AP Media API Portal. All users within your organization will have the same exact view - they will see all profiles and agents for your organization.

How do I get up and running with the AP Media Agent?

Watch an intro tutorial and follow the quick steps to configure and set up your agent in Getting Started.

What version of Java should I install to run the agent?

The latest Java Runtime Environment (JRE). Mac OS X users can install the latest Java version via Software Update. Windows and Linux users can download the most current Java version from http://java.com.

Can I change the name of the agent Java file?

It is strongly recommended not to rename the agent jar file. If you are planning to run multiple agents on the same machine, each agent jar file must be in its own folder.

How do I install the Agent service?

See Running the Agent as a Service.

Can I specify the port that the local Agent Management page uses?

Yes. See Can I change the local port that the Agent Management page uses?

Can I disable the local Agent Management page server?

Yes. See Can I disable the local Agent Management page server?

Can I run more than one agent on a single machine?

Yes, you can run multiple agents on the same machine. If you are planning to run multiple agents on the same machine, each agent jar file must be in its own folder. See the tips in Download and Register Agent in Getting Started.

How do I find agent logs for troubleshooting?

The agent logs are in the logs folder below the directory where your agent jar file is located.

Do I need to install a new agent if I'm coming from AP WebFeeds?

Yes, you must install the AP Media API Agent. AP WebFeeds Agent is not compatible with AP Media API.

Can I start and stop the agent ingestion remotely, without having to log into the local machine the agent is running on?

Yes, you can stop and restart content ingestion from the portal as long as the agent process is running. See How do I stop ingesting? and Restarting Ingestion.

When I first start my agent, I see a bunch of stories/photos/videos/audio downloaded immediately. Why does this happen?

When first started, the agent pulls the most recent 50 items from the feed.

When should I choose the JSON: Associated Item Files option?

See JSON: Associated Item Files.

Why can't I delete my agent?

You can delete an agent from the portal only after it has been off for a certain period of time (currently after two hours).

How do I import a profile from AP WebFeeds into the AP Media API Portal?

See How do I import a profile?

How do I run the agent from a terminal/command line?

See Can I launch the agent from a command prompt?

How do I run the agent if I'm running a proxy server?

See How can I run the agent using a proxy server?

How can I manage duplicate content being downloaded by the agent?

By default, the agent does not ingest duplicate content. If you are interested in saving duplicate content, see How can I save duplicates?

What naming conventions are available for content downloaded by the agent?

See Content File Naming Format.

Where can I find the agent ID of a particular agent?

You can find it in the agent details on the Manage Ingest Agent page. See Where can I view agent details?

Where can I find the agent version I am running?

You can find it in the agent details on the Manage Ingest Agent page. See Where can I view agent details?

Where can I find the hostname of the machine that the agent is running on?

You can find it in the agent details on the Manage Ingest Agent page. See Where can I view agent details?

More FAQs

Review additional FAQs that apply to both the API and the agent.