Skip to main content

API wrapper for the Amazon Ads API

Project description

Amazon Ads API Connector

A simple Python wrapper for the latest version of the Amazon Ads API for Sponsored Products campaign management.

This module covers the key endpoints for managing Sponsored Products campaigns. This includes methods for authentication, pagination and report generation. It features keyword and negative keyword targeting, as well as product ASIN targeting and auto campaigns.

Please note that this module does not yet support Sponsored Brands and Sponsored Display campaigns.

Installation

Amazon Ads API Connector is available on PyPI:

pip install amazon-ads-api-connector

Getting started

The primary class of the module is AmazonAdsAPIConnector. This class provides methods to create, list, update and delete

  • campaigns,
  • ad groups,
  • product ads,
  • keywords,
  • negative keywords, and
  • targeting clauses (ASIN targeting).

It furthermore provides methods to get keyword recommendations, which include bid recommendations for keyword targets, as well as bid recommendations for ad groups, which include bid recommendations for auto campaigns.

And lastly, it provides also methods to request and retrieve reports via the API.

To create an instance of the AmazonAdsAPIConnector, you need to pass your Amazon Ads API credentials as a dictionary. The dictionary must contain the following keys:

  • refresh_token
  • client_id
  • client_secret
  • profile_id

Upon initialization, the AmazonAdsAPIConnector object will create a new access token. This access token will be valid for 60 minutes, however, the object automatically requests a new access token in case it has expired when trying to make a new request.

You furthermore need to specify the region of your Amazon Ads account. The region is specified by the Region enum, which is part of the amazon_ads_api_connector module. The Amazon Ads API supports the following regions:

  • North America: Region.NA
  • Europe: Region.EU
  • Far East: Region.FE

For more information about the Amazon Ads API, please visit the official documentation.

Examples

Import the library

from amazon_ads_api_connector import AmazonAdsAPIConnector, Region

Create an instance

api = AmazonAdsAPIConnector(
    {
        "refresh_token": "your_refresh_token",
        "client_id": "your_client_id",
        "client_secret": "your_client_secret",
        "profile_id": "your_profile_id",
    },
    Region.EU,
)

List campaigns

campaigns = api.list_campaigns()

Create campaigns

api.create_campaign(
    campaigns=[
        {
            "name": "My Campaign",
            "targetingType": "MANUAL",
            "state": "ENABLED",
            "dynamicBidding": {
                "strategy": "LEGACY_FOR_SALES",
            },
            "bugdget": {
                "budgetType": "DAILY",
                "budget": 0,
            },
        },
    ]
)

Please note that all create and update methods expect a list of dictionaries as their only argument. This reflects the fact that the Amazon Ads API allows to create or update multiple objects at once. To ensure the greatest possible flexibility, the structure of the list and the dictionaries corresponds to the structure specified by the API and described in the API documentation. For more information about the structure of the lists and dictionaries, as well for information on data limits per request, please visit the official documentation.

Request and retrieve a report

The module contains classes which represent basic configurations of the available report types:

  • CampaignsReport
  • TargetingReport
  • SearchTermReport
  • AdvertisedProductReport
  • PurchasedProductReport

For more information about the report types, please visit the official documentation.

To request a report you need to pass an instance of one of these classes to the create_report method of the AmazonAdsAPIConnector class. To customize the report, change the properties of the class instance before passing it to the create_report method.

from amazon_ads_api_connector import SearchTermReport

report_configuration = SearchTermReport("2023-10-01", "2023-10-07")

res = api.create_report(report_configuration)
report = api.get_report(res)

Please note that report gerneration is asynchronous. The create_report method returns a dictionary containing the report ID. The get_report takes this dictionary as an argument and returns the report once it is completed and available. The completion of a report usually takes a few minutes and can take up to 3 hours.

Dependencies

This module depends on the httpx library, which is not included in the Python standard library, but will be installed automatically when you install the amazon-ads-api-connector package.

Disclaimer

I am not affiliated with Amazon in any way. This module is an independent project that aims to provide a simple and easy-to-use interface to the Amazon Ads API for Sponsored Products campaign management. I do not guarantee the correctness or completeness of the module. Use it at your own risk.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

amazon_ads_api_connector-0.1.8.tar.gz (11.4 kB view details)

Uploaded Source

Built Distribution

amazon_ads_api_connector-0.1.8-py3-none-any.whl (12.4 kB view details)

Uploaded Python 3

File details

Details for the file amazon_ads_api_connector-0.1.8.tar.gz.

File metadata

File hashes

Hashes for amazon_ads_api_connector-0.1.8.tar.gz
Algorithm Hash digest
SHA256 9de625a6c15de7781db3bc6ee3af495488adc95ae88d80d58bc662a20efafba6
MD5 92278c790bc98474013126be3b6f8959
BLAKE2b-256 75e5698ebea687c8d006d665fd24b920981b361e3589d4ae81d3392eb53620dd

See more details on using hashes here.

File details

Details for the file amazon_ads_api_connector-0.1.8-py3-none-any.whl.

File metadata

File hashes

Hashes for amazon_ads_api_connector-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 cf23f32bc817ba07ac2d4c1f6467f55c2cc5c7f924cd3ef06b4b965b003f4cb8
MD5 9e7bf78c03c87c873c78e9b810b69ede
BLAKE2b-256 5c84ab02cfbf0acbd6b9759a4dfac6244bc13d22d90836b5879a8426b7d18f87

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page