Using SDK

CreatorsAPI provides SDKs for multiple programming languages to simplify integration. Each SDK handles authentication, request signing, and API communication automatically, allowing you to focus on building your application.

Before using any SDK, you need to generate credentials from Amazon Associates Central. Follow the instructions in the Register for Creators API guide to create your credentials (Client ID, Client Secret, and Version).

Available SDKs

CreatorsAPI offers SDKs for the following languages:

• Node.js - For JavaScript/TypeScript applications

• Python - For Python applications

• PHP - For PHP applications

• Java - For Java applications

Node.js SDK

Installation & Setup

1. Download & extract

   • Download creatorsapi-nodejs-sdk and extract the archive file

   • Navigate to the extracted directory

2. Install dependencies

   • Run npm install to install all required dependencies

   • Run npm run build to build the SDK

3. Configure credentials

   • Open the project in any editor of your preference

   • Navigate to the examples directory

   • Add your Credential ID, Credential Secret and Version in the sample files

   • Add your marketplace to which you want to send the request (e.g., "www.amazon.com" for US marketplace)

   • Add valid Partner Tag for the requested marketplace in applicable sample code snippet files

4. Run sample code

   • Execute samples like node sampleGetItems.js to get item details

   • Try node sampleSearchItems.js to search for items

Example Files

• sampleGetItems.js - Retrieve item information by ASIN

• sampleSearchItems.js - Search for items using keywords

Python SDK

Installation & Setup

1. Download & extract

   • Download creatorsapi-python-sdk and extract the archive file

   • Navigate to the extracted directory

2. Install dependencies

   • Install dependencies using pip3 install -r requirements.txt

3. Configure credentials

   • Open the project in any editor of your preference

   • Navigate to the examples directory

   • Add your Credential ID, Credential Secret and Version in the sample files

   • Add your marketplace to which you want to send the request (e.g., "www.amazon.com" for US marketplace)

   • Add valid Partner Tag for the requested marketplace in applicable sample code snippet files

4. Run sample code

   • Execute samples like python3 sample_get_items.py to get item details

   • Try python3 sample_search_items.py to search for items

Example Files

• sample_get_items.py - Retrieve item information by ASIN

• sample_search_items.py - Search for items using keywords

PHP SDK

Installation & Setup

1. Download & extract

   • Download creatorsapi-php-sdk and extract the archive file

   • Navigate to the extracted directory

2. Install dependencies

   • Install dependencies using composer install

3. Configure credentials

   • Open the PHP project in any editor of your preference

   • Navigate to the examples directory

   • Add your Credential ID, Credential Secret and Version in sample code snippet files

   • Add your marketplace to which you want to send the request (e.g., "www.amazon.com" for US marketplace)

   • Add valid Partner Tag for the requested marketplace in applicable sample code snippet files

4. Run sample code

   • Execute samples like php SampleGetItems.php to get item details

   • Try php SampleSearchItems.php to search for items

Example Files

• SampleGetItems.php - Retrieve item information by ASIN

• SampleSearchItems.php - Search for items using keywords

Java SDK

Installation & Setup

1. Download & extract

   • Download creatorsapi-java-sdk and extract the archive file

   • Navigate to the extracted directory

2. Configure credentials

   • Open the project in any editor of your preference

   • Add all jars present in dependencies folder to the build path

   • Navigate to the examples directory

   • Add your Credential ID, Credential Secret and Version in sample code snippet files

   • Add your marketplace to which you want to send the request (e.g., "www.amazon.com" for US marketplace)

   • Add valid Partner Tag for the requested marketplace in applicable sample code snippet files

3. Run sample code

   • Execute samples like SampleGetItems.java to get item details

   • Try SampleSearchItems.java to search for items

Example Files

• SampleGetItems.java - Retrieve item information by ASIN

• SampleSearchItems.java - Search for items using keywords

Best Practices

• Token Management: The SDK automatically handles access token caching and renewal. Tokens are cached until they expire (1 hour by default)

• Error Handling: Always implement proper error handling in your application code when making API calls

• Rate Limiting: Be mindful of API rate limits. Implement appropriate throttling in your application

• Security: Never commit your credentials (Credential ID, Credential Secret) to version control or expose them in client-side code

SDK Changelog