Skip to main content

AP Images

The AP Images integration provides access to an enormous library of images. When you identify an image to use, you import it into Brightspot and then add it to assets such as articles and galleries.

This section describes how to configure the integration in Brightspot, and how to perform an integrated search.

The integration requires an AP Newsroom account. See newsroom.ap.org.

Including AP Images in a build​

The following table lists the dependencies to include in your build configuration.

ArtifactDescription
com.psddev:apExposes the external type AssociatedPressImage and fields in Edit Site to configure and run integrated search with AP Images.

Runtime prerequisites​

  • Developer configuration—Extend ExternalItemConverter to import the AssociatedPressImage as a Brightspot Image.
  • Ops configuration—Generate an API key in the AP Images console.
  • CMS configuration—Configure the site interfacing with AP Images. For details, see Configuring the AP Images integration.

Importing an image from AP Images​

Use the following procedure to search for and use an image from AP Images.

To search for and use an AP Images image:

  1. Open the search panel.
  2. Set the content types filter to AP Image.
  3. Add other filters or search text. For additional information, see Search filters. Brightspot lists any matching images.
  4. Click on the image.
  5. In the content edit form, click Import.

Brightspot imports the image and displays it in a content edit form. You can modify the title, credit, or other metadata, and then use the image in an asset.

For additional information about importing external assets, see Importing external videos.

See also:

Configuration​

You can configure integrated search with AP Images at the Global level or the site level. Global configurations are inherited by all sites, and site-level configurations override Global configurations. This topic explains how to configure this integrated search at the Global level.

To configure integrated search with AP Images:

  1. In your AP Images console, obtain your API key.
  2. Click > Admin > Sites & Settings > Sites > Global.
  3. From the Integrations tab, expand the Associated Press cluster.
  4. From the Associated Press API Client list, click Create New.
  5. In the Name field, enter a name for the integration.
  6. In the API Key field, paste the value from step 1.
  7. Click Save.
  8. Click Back.
  9. From the Associated Press API Client list, select the integration you created.
  10. Click Save.