ScavioScavio

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

EndpointDescription
POST /api/v1/amazon/searchSearch Amazon products with sorting, pagination, and category filters
POST /api/v1/amazon/productGet detailed product information by ASIN

Authentication

HeaderValueRequired
AuthorizationBearer YOUR_API_KEYYes
Content-Typeapplication/jsonYes

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

ParameterTypeDefaultDescription
querystring--Required. Search query (1-500 chars).
domainstringcomAmazon domain suffix (e.g. com, co.uk, de, fr, co.jp).
sort_bystring--Sort order. One of: most_recent, price_low_to_high, price_high_to_low, featured, average_review, bestsellers
start_pageinteger1Starting page number (1-indexed).
pagesinteger1Number of pages to return.
category_idstring--Amazon category/department ID to narrow results.
merchant_idstring--Filter by specific Amazon merchant.
countrystring--Country code for localization.
languagestring--Language code for results.
currencystring--ISO 4217 currency code (e.g. USD, EUR, GBP).
devicestringdesktopDevice type. One of: desktop, mobile, tablet
zip_codestring--ZIP/postal code for localized pricing and availability.
autoselect_variantboolean--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": {
    "page": 1,
    "products": [
      {
        "asin": "B09XS7JWHH",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/dp/B09XS7JWHH",
        "url_image": "https://m.media-amazon.com/images/I/...",
        "price": 278.0,
        "price_strikethrough": 399.99,
        "currency": "USD",
        "rating": 4.6,
        "reviews_count": 12450,
        "is_prime": true,
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "organic_position": 1,
        "sponsored_position": null,
        "sales_volume": "1K+ bought in past month",
        "shipping_information": "FREE delivery Mon, Apr 13",
        "manufacturer": "",
        "variations": []
      }
    ],
    "html": ""
  },
  "response_time": 1850,
  "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

ParameterTypeDefaultDescription
querystring--Required. Amazon ASIN (e.g. B09XS7JWHH).
domainstringcomAmazon domain suffix (e.g. com, co.uk, de).
countrystring--Country code for localization.
languagestring--Language code for results.
currencystring--ISO 4217 currency code (e.g. USD, EUR).
devicestringdesktopDevice type. One of: desktop, mobile, tablet
zip_codestring--ZIP/postal code for localized pricing.
autoselect_variantboolean--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": {
    "asin": "B09XS7JWHH",
    "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "brand": "Sony",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": 278.0,
    "price_strikethrough": 399.99,
    "highest_price": 399.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "bullet_points": "NOISE CANCELLATION: ...
LONG BATTERY LIFE: Up to 30 hours...",
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "category": "Electronics",
    "stock": "In Stock",
    "is_prime": true,
    "buybox": [
      {
        "condition": "Buy new:",
        "price": 278.0,
        "seller_name": "Amazon.com",
        "stock": "In Stock"
      }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 998
}

Supported Domains

Use the domain parameter to target a specific Amazon marketplace:

DomainMarketplace
comUnited States
co.ukUnited Kingdom
deGermany
frFrance
co.jpJapan
caCanada
itItaly
esSpain
inIndia
com.auAustralia
com.brBrazil
com.mxMexico

Response Format

Both endpoints return a consistent response wrapper:

FieldTypeDescription
dataobject | nullThe response payload. null if the request failed upstream. Search returns {page, products, html}; product returns the product object directly.
response_timenumberServer-side response time in milliseconds
credits_usednumberNumber of credits consumed
credits_remainingnumberCredits remaining in your current billing period

Error Responses

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

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

Related