Getting Started

1. Create an account

Register or sign in to Ecommerce Data API, then open Settings > API Keys, or go directly to Create API key.

2. Create an API key

Create a key for your application on the API key page. The complete secret is displayed once. Store it in a server-side environment variable and never expose it in browser code or a public repository.

export ECOMMERCE_DATA_API_KEY='ecom_live_your_key'

3. Send a request

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/products/details \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
    "marketplace": "US",
    "asin": "B08CK5Z5Q1"
  }'

Every successful response contains a service-generated request_id and endpoint-specific data:

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": {
    "asin": "B08CK5Z5Q1",
    "marketplace": "US",
    "title": "Example product",
    "price": 19.99,
    "rating": 4.6,
    "ratings": 1284
  }
}

Use request_id when investigating a call in the usage dashboard or contacting support.

4. Check service health

The health endpoint does not require authentication:

curl https://ecommercedataapi.com/v1/health

Supported marketplaces

US, UK, DE, FR, IT, ES, MX, CA, AU, JP, IN, AE, BR

Marketplace and ASIN values are normalized to uppercase. Unless documented otherwise, omitted marketplace values default to US.