Skip to main content

Amazon Ads

info

API Documentation: Amazon Ads API Documentation

High-Level Information:

The Amazon Ads API allows you to access various data related to advertising on Amazon. The integration focuses on pulling data for the following types of ads:

  1. Sponsored Products: Ads for individual product listings on Amazon, appearing in search results and on product detail pages.
  2. Sponsored Display: Ads that appear both on and off Amazon, targeting audiences with various options for product discovery and retargeting.
  3. Sponsored Brands: Ads featuring your brand logo, a custom headline, and multiple products, designed to drive brand discovery and consideration.

Authentication​

To authenticate the Amazon Ads source, you’ll connect via OAuth to your Amazon Ads account.

  • An Amazon Ads account with access to the advertisers/profiles you want to sync.
  • Permission to authorize the Amazon Ads API for your organization.

Set up authentication​

  1. In the app, open Sources and select Amazon Ads.
  2. Click Authenticate (or Connect) to start the OAuth flow.
  3. Sign in to Amazon and grant access when prompted.
  4. After authorization completes, return to the app to finish creating the source.

Notes​

  • Access is granted per Amazon Ads login and the profiles (advertisers) available to that login.
  • If you lose access or permissions change, re-authenticate the source to refresh authorization.

Source Setup Guide​

Select your Region from the dropdown. Amazon Ads operates in different regional marketplaces, and the connector uses the selected region to choose the correct API base URL:

  • North America (NA): United States, Canada, Mexico, Brazil
  • Europe (EU): United Kingdom, Germany, France, Italy, Spain, Netherlands, Sweden, Poland, Belgium, Turkey
  • Far East (FE): Japan, Australia, Singapore, India

Note: Region is required to connect.

Step 2​

Click connect in the Edit Source form to the left.

Step 3​

Follow the authentication flow (OAuth) on Amazon's website to grant Extract the required permissions.

Step 4​

Ensure that your email is visible, and verify that the source status is Connected.

Connection Setup Guide​

Once you connected Amazon Ads to a destination, you will also need to configure:

  • Connection Pull Schedule: Determines how frequently data is extracted from the source.
  • Backfill (Days): Specifies the duration for which historical data will be retrieved during each connection run.
  • Profiles Whitelist: Select specific advertising profiles to sync, or all of them.
  • Destination specific settings: Different settings such as "Dataset Name" or "Target Schema" (depending on your destination).
  • Schema Migration Policy: Controls how Extract will handle schema changes from the source.

If you are using Amazon Ads as a destination (DSP Conversions API), you will also need to provide the required destination credentials (for example, your Amazon Ads client ID and an OAuth refresh token) and select the Amazon Ads account/profile to send events to.

Connector Information​

Schema ERD​

Explore the interactive entity relationship diagram for Amazon Ads.

Open page

Data Streams​

portfolios​

Loading ....

profiles​

Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....

Metadata​

portfolios​

Loading ....

profiles​

Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....

Reports​

Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....
Loading ....