# 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.

{% hint style='info' %}
Before using any SDK, you need to generate credentials from Amazon Associates Central. Follow the instructions in the [Register for Creators API](en-us/onboarding/register-for-creators-api) guide to create your credentials (Client ID, Client Secret, and Version).
{% endhint %}

## 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

![](/creatorsapi/docs/assets/badges/LatestNodeJsStableVersion.svg)

### Installation & Setup

1. **Download & extract**
   - Download [**creatorsapi-nodejs-sdk**](/creatorsapi/docs/assets/sdk-archived/creatorsapi-nodejs-sdk.zip) 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

![](/creatorsapi/docs/assets/badges/LatestPythonStableVersion.svg)

### Installation & Setup

1. **Download & extract**
   - Download [**creatorsapi-python-sdk**](/creatorsapi/docs/assets/sdk-archived/creatorsapi-python-sdk.zip) 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

![](/creatorsapi/docs/assets/badges/LatestPHPStableVersion.svg)

### Installation & Setup

1. **Download & extract**
   - Download [**creatorsapi-php-sdk**](/creatorsapi/docs/assets/sdk-archived/creatorsapi-php-sdk.zip) 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

![](/creatorsapi/docs/assets/badges/LatestJAVAStableVersion.svg)

### Installation & Setup

1. **Download & extract**
   - Download [**creatorsapi-java-sdk**](/creatorsapi/docs/assets/sdk-archived/creatorsapi-java-sdk.zip) 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

| Version | Release Date | Changes |
|---------|--------------|---------|
| **1.2.0** | February 22, 2026 | • Added support for v3 credentials |
| **1.1.3** | February 3, 2026 | • Fixed Price in GetVariations operation<br>• General bug fixes and improvements |
| **1.1.2** | January 12, 2026 | • Fixed SortBy parameter functionality in SearchItems operation<br>• General bug fixes and improvements |
| **1.1.0** | January 9, 2026 | • Added support for Reporting API (S3 Report generation and management) |
| **1.0.0** | December 15, 2025 | • Initial release of CreatorsAPI SDKs<br>• Support for Products API operations (GetItems, SearchItems, GetBrowseNodes, GetVariations)<br>• Automatic authentication and token management<br>• Token caching with automatic renewal |

