Amazon API

The Amazon API lets you search products and retrieve detailed product information by ASIN. Both endpoints support multi-region targeting, currency localization, and device emulation.

Endpoints

Endpoint	Description
`POST /api/v1/amazon/search`	Search Amazon products with sorting, pagination, and category filters
`POST /api/v1/amazon/product`	Get detailed product information by ASIN

Authentication

Header	Value	Required
`Authorization`	`Bearer YOUR_API_KEY`	Yes
`Content-Type`	`application/json`	Yes

Product Search

Bash

POST https://api.scavio.dev
/api/v1/amazon/search

Search Amazon products and get structured results including pricing, ratings, and product details.

Request Body

Parameter	Type	Default	Description
`query`	`string`	--	Required. Search query (1-500 chars).
`domain`	`string`	`com`	Amazon domain suffix (e.g. `com`, `co.uk`, `de`, `fr`, `co.jp`).
`sort_by`	`string`	--	Sort order. One of: `most_recent`, `price_low_to_high`, `price_high_to_low`, `featured`, `average_review`, `bestsellers`
`start_page`	`integer`	`1`	Starting page number (1-indexed).
`pages`	`integer`	`1`	Number of pages to return.
`category_id`	`string`	--	Amazon category/department ID to narrow results.
`merchant_id`	`string`	--	Filter by specific Amazon merchant.
`country`	`string`	--	Country code for localization.
`language`	`string`	--	Language code for results.
`currency`	`string`	--	ISO 4217 currency code (e.g. `USD`, `EUR`, `GBP`).
`device`	`string`	`desktop`	Device type. One of: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	ZIP/postal code for localized pricing and availability.
`autoselect_variant`	`boolean`	--	Automatically select the default product variant.

Example

curl -X POST 'https://api.scavio.dev
/api/v1/amazon/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "average_review",
    "domain": "com",
    "pages": 1
  }'

Response Example

JSON

{
  "data": [
    {
      "name": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
      "asin": "B09XS7JWHH",
      "url": "https://www.amazon.com/dp/B09XS7JWHH",
      "price": "$278.00",
      "currency": "USD",
      "rating": 4.6,
      "total_reviews": 12450,
      "image": "https://m.media-amazon.com/images/I/...",
      "is_prime": true,
      "is_best_seller": false,
      "is_sponsored": false
    }
  ],
  "response_time": 1.85,
  "credits_used": 1,
  "credits_remaining": 999
}

Product Details

Bash

POST https://api.scavio.dev
/api/v1/amazon/product

Get detailed information for a specific Amazon product by its ASIN. Returns pricing, description, specifications, images, ratings, and seller information.

Request Body

Parameter	Type	Default	Description
`query`	`string`	--	Required. Amazon ASIN (e.g. `B09XS7JWHH`).
`domain`	`string`	`com`	Amazon domain suffix (e.g. `com`, `co.uk`, `de`).
`country`	`string`	--	Country code for localization.
`language`	`string`	--	Language code for results.
`currency`	`string`	--	ISO 4217 currency code (e.g. `USD`, `EUR`).
`device`	`string`	`desktop`	Device type. One of: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	ZIP/postal code for localized pricing.
`autoselect_variant`	`boolean`	--	Automatically select the default product variant.

Example

curl -X POST 'https://api.scavio.dev
/api/v1/amazon/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "B09XS7JWHH"}'

Response Example

JSON

{
  "data": {
    "name": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "asin": "B09XS7JWHH",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": "$278.00",
    "list_price": "$399.99",
    "currency": "USD",
    "rating": 4.6,
    "total_reviews": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "features": [
      "Industry Leading Noise Cancellation",
      "Magnificent Sound Quality",
      "Crystal clear hands-free calling",
      "Up to 30-hour battery life"
    ],
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "categories": ["Electronics", "Headphones"],
    "availability": "In Stock",
    "seller": "Amazon.com",
    "is_prime": true
  },
  "response_time": 2.14,
  "credits_used": 1,
  "credits_remaining": 998
}

Supported Domains

Use the domain parameter to target a specific Amazon marketplace:

Domain	Marketplace
`com`	United States
`co.uk`	United Kingdom
`de`	Germany
`fr`	France
`co.jp`	Japan
`ca`	Canada
`it`	Italy
`es`	Spain
`in`	India
`com.au`	Australia
`com.br`	Brazil
`com.mx`	Mexico

Response Format

Both endpoints return a consistent response wrapper:

Field	Type	Description
`data`	`object \| array \| null`	The response payload. `null` if the request failed upstream.
`response_time`	`number`	Server-side response time in seconds
`credits_used`	`number`	Number of credits consumed
`credits_remaining`	`number`	Credits remaining in your current billing period

Error Responses

Status	Description
`401`	Unauthorized -- missing or invalid API key
`429`	Rate or usage limit exceeded for your plan
`502`	Upstream error -- retry after a short delay
`503`	Upstream unavailable -- retry later

See Errors for the full error reference and retry best practices.

Quickstart -- get your API key and make your first request
Google Search API -- search Google with structured SERP data
YouTube API -- search videos, extract metadata and transcripts
Rate Limits -- limits per plan tier

Amazon API

Endpoints

Authentication

Product Search

Request Body

Example

Response Example

Product Details

Request Body

Example

Response Example

Supported Domains

Response Format

Error Responses

Related