MENU navbar-image

📦 Amazon

Amazon product API that returns search results, product pages, prices, reviews, offers, deals, rankings, and seller data from Amazon's public pages.

Most endpoints take a country code that picks the marketplace domain, currency, and default language. Supported codes (case-insensitive): US, CA, MX, BR, UK, DE, IT, SA, TR, ES, FR, IN, AE, NL, SE, PL, EG, ZA, BE, NG, IE, JP, AU, SG. The default is US, and the United Kingdom is UK, not GB.

General

Keyword autocomplete, keyword search, and category browsing for Amazon products.

GET /v1/autocomplete

requires authentication

Returns the suggestions Amazon's search box shows for a partial or full search term, as a plain list of strings. Use it to build search-as-you-type or to expand a keyword list before calling product search.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/keywords/autocomplete'
params = {
  'keyword': 'wireless earbuds',
  'country': 'US',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/keywords/autocomplete';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'keyword' => 'wireless earbuds',
            'country' => 'US',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/keywords/autocomplete"
);

const params = {
    "keyword": "wireless earbuds",
    "country": "US",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/keywords/autocomplete?keyword=wireless+earbuds&country=US" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
        "version": "v1.0",
        "status": 200,
        "copywrite": "https://steadyapi.com",
        "marketplace": "https://amazon.com",
        "country": "US",
        "currency": "USD",
        "keyword": "wireless earbuds"
    },
    "body": [
        "wireless earbuds",
        "wireless earbuds for iphone",
        "tozo wireless earbuds",
        "wireless earbuds noise cancelling",
        "true wireless earbuds",
        "wireless earbuds for android",
        "wireless earbuds bluetooth",
        "wireless earbuds jbl",
        "wireless earbuds beats",
        "jlan wireless earbuds"
    ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (422, Validation Failed):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/keywords/autocomplete

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
keyword required string

Search term to complete, up to 50 characters. Example: wireless earbuds

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: US

language optional string

Locale code for the Amazon page. A value the selected marketplace does not support falls back to that marketplace's first language. Supported values:

  • US: en_US, es_US
  • AU: en_AU
  • BR: pt_BR
  • CA: en_CA, fr_CA
  • FR: fr_FR, en_GB
  • DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK
  • IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN
  • IT: it_IT, en_GB
  • MX: es_MX
  • NL: nl_NL, en_GB
  • SG: en_SG
  • ES: es_ES, pt_PT, en_GB
  • TR: tr_TR
  • AE: en_AE, ar_AE
  • UK: en_US
  • ZA, NG, IE: en_US
  • JP: ja_JP, en_US, zh_CN
  • SA: ar_AE, en_AE
  • PL: pl_PL
  • SE: sv_SE, en_GB
  • BE: fr_BE, nl_BE, en_GB
  • EG: ar_AE, en_AE

requires authentication

Searches Amazon by keyword and returns one page of product results, each with ASIN, title, price, star rating, rating count, photo, badges, and delivery text. Narrow the results by price, category, condition, Prime eligibility, or rating, and change the sort order with sort_by.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/products/search'
params = {
  'search': 'Pens',
  'country': 'US',
  'sort_by': 'RELEVANCE',
  'category_id': '17238450011',
  'seller_id': 'ARVLBD5MF9H1U',
  'condition': 'new',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/products/search';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'search' => 'Pens',
            'country' => 'US',
            'sort_by' => 'RELEVANCE',
            'category_id' => '17238450011',
            'seller_id' => 'ARVLBD5MF9H1U',
            'condition' => 'new',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/products/search"
);

const params = {
    "search": "Pens",
    "country": "US",
    "sort_by": "RELEVANCE",
    "category_id": "17238450011",
    "seller_id": "ARVLBD5MF9H1U",
    "condition": "new",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/products/search?search=Pens&country=US&sort_by=RELEVANCE&category_id=17238450011&seller_id=ARVLBD5MF9H1U&condition=new" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
      "version": "v1.0",
      "status": 200,
      "copywrite": "https://steadyapi.com",
      "marketplace": "https://amazon.com",
      "search": "phone",
      "total": 100000,
      "page": 1
    },
    "body": [
      {
        "asin": "B0DLHNWHRF",
        "product_title": "Samsung Galaxy A16 5G A Series, Unlocked Android Smartphone, Large AMOLED Display, Durable Design, Super Fast Charging, Expandable Storage, 5G Connectivity, US Version, 2025, Blue Black",
        "product_price": "$174.99",
        "product_original_price": "$199.99",
        "currency": "USD",
        "product_star_rating": "4.2",
        "product_num_ratings": 997,
        "product_url": "https://amazon.com/dp/B0DLHNWHRF",
        "product_photo": "https://m.media-amazon.com/images/I/71KGkQ+KOKL._AC_UY218_.jpg",
        "product_num_offers": null,
        "product_minimum_offer_price": null,
        "is_best_seller": false,
        "is_amazon_choice": false,
        "is_prime": false,
        "climate_pledge_friendly": false,
        "sales_volume": "9K+ bought in past month",
        "delivery": "FREE delivery Fri, Jul 11",
        "has_variations": false,
        "product_badge": "Limited time deal"
      },
      { ... }
    ]
  }
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

GET /v1/by-category

requires authentication

Lists Amazon products in one category without a keyword. Returns the same product fields as product search and accepts the same sort and filter options. Pass a numeric browse node ID in category_id; if it is missing or not numeric, no category filter is sent to Amazon.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/products/by-category'
params = {
  'category_id': '17238450011',
  'country': 'US',
  'sort_by': 'RELEVANCE',
  'seller_id': 'ARVLBD5MF9H1U',
  'condition': 'new',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/products/by-category';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'category_id' => '17238450011',
            'country' => 'US',
            'sort_by' => 'RELEVANCE',
            'seller_id' => 'ARVLBD5MF9H1U',
            'condition' => 'new',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/products/by-category"
);

const params = {
    "category_id": "17238450011",
    "country": "US",
    "sort_by": "RELEVANCE",
    "seller_id": "ARVLBD5MF9H1U",
    "condition": "new",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/products/by-category?category_id=17238450011&country=US&sort_by=RELEVANCE&seller_id=ARVLBD5MF9H1U&condition=new" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
      "version": "v1.0",
      "status": 200,
      "copywrite": "https://steadyapi.com",
      "marketplace": "https://amazon.com",
      "total": 1000,
      "page": 1,
      "country": "US",
      "sort_by": "RELEVANCE",
      "category_id": "17238450011"
    },
    "body": [
      {
        "asin": "B09LMBLYF1",
        "product_title": "Transformable Fidget Spinners 4 Pcs for Kids and Adults Stress Relief Sensory Toys for Boys and Girls Fingertip Gyros for Party Favors Stocking Stuffers Bulk for Kids",
        "product_price": "$9.98",
        "product_original_price": "$16.98",
        "currency": "USD",
        "product_star_rating": "4.6",
        "product_num_ratings": 8102,
        "product_url": "https://amazon.com/dp/B09LMBLYF1",
        "product_photo": "https://m.media-amazon.com/images/I/71mr6NdQE4L._AC_UL320_.jpg",
        "product_num_offers": null,
        "product_minimum_offer_price": null,
        "is_best_seller": true,
        "is_amazon_choice": false,
        "is_prime": false,
        "climate_pledge_friendly": true,
        "sales_volume": "10K+ bought in past month",
        "delivery": "FREE delivery Fri, Jul 11 on $35 of items shipped by Amazon",
        "has_variations": false,
        "product_badge": "Limited time deal"
      },
      { ... }
    ]
  }
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/products/by-category

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
category_id optional string

Numeric Amazon category (browse node) ID, such as 17238450011. The forms n:17238450011, 3A17238450011, and %3A17238450011 copied from a URL like https://www.amazon.com/s?rh=n%3A17238450011 also work. Values that are not numeric after the prefix is removed are ignored. Example: 17238450011

page optional integer

Results page, from 1 to 500. Defaults to 1.

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: US

language optional string

Locale code for the Amazon page. A value the selected marketplace does not support falls back to that marketplace's first language. Supported values:

  • US: en_US, es_US
  • AU: en_AU
  • BR: pt_BR
  • CA: en_CA, fr_CA
  • FR: fr_FR, en_GB
  • DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK
  • IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN
  • IT: it_IT, en_GB
  • MX: es_MX
  • NL: nl_NL, en_GB
  • SG: en_SG
  • ES: es_ES, pt_PT, en_GB
  • TR: tr_TR
  • AE: en_AE, ar_AE
  • UK: en_US
  • ZA, NG, IE: en_US
  • JP: ja_JP, en_US, zh_CN
  • SA: ar_AE, en_AE
  • PL: pl_PL
  • SE: sv_SE, en_GB
  • BE: fr_BE, nl_BE, en_GB
  • EG: ar_AE, en_AE
sort_by optional string

Sort order: RELEVANCE, LOWEST_PRICE, HIGHEST_PRICE, REVIEWS, NEWEST, or BEST_SELLERS (case-insensitive). Defaults to RELEVANCE. Example: RELEVANCE

low_price optional number

Minimum price in the marketplace currency. Decimals are dropped, so 19.99 is sent as 19.

high_price optional number

Maximum price in the marketplace currency; must be greater than or equal to low_price. Decimals are dropped.

seller_id optional string

Amazon seller ID, sent to Amazon as a p_6: seller refinement. To list one seller's catalog, use the Seller Products endpoint. Example: ARVLBD5MF9H1U

is_prime optional string

Set to true to return only Prime-eligible items. Allowed: true, false.

min_rating_4 optional string

Set to true to return only items rated 4 stars and up. Allowed: true, false.

condition optional string

Item condition: new, used, or renewed. collectible is accepted but not applied as a filter. Example: new

additional_filters optional string

Comma-separated raw Amazon rh refinements added to the query as is, for example p_n_feature_four_browse-bin:123456,p_n_condition-type:6461716011.

Product

Product data looked up by ASIN: full details, batch lookups, variations, prices, similar items, seller offers, and top reviews.

GET /v1/details

requires authentication

Returns the data on one Amazon product page: title, prices, photos, videos, feature bullets, description, star rating, availability, badges, the product details table, the "customers say" summary, and variations. Reviews are not included; use the product reviews endpoint for those.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/products/details'
params = {
  'asin': 'B07ZPKBL9V',
  'country': 'US',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/products/details';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'asin' => 'B07ZPKBL9V',
            'country' => 'US',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/products/details"
);

const params = {
    "asin": "B07ZPKBL9V",
    "country": "US",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/products/details?asin=B07ZPKBL9V&country=US" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
      "version": "v1.0",
      "status": 200,
      "copywrite": "https://steadyapi.com",
      "marketplace": "https://amazon.com",
      "asin": "B0BNBR5XC4",
      "country": "US"
    },
    "body": {
      "asin": "B0BNBR5XC4",
      "product_title": "Amazon Essentials Men's Derby Shoe",
      "product_price": "$34.50",
      "product_original_price": null,
      "unit_price": null,
      "product_price_max": null,
      "minimum_order_quantity": null,
      "categories": [
        {
          "id": "7141123011",
          "name": "Clothing, Shoes & Jewelry",
          "link": "https://amazon.com/amazon-fashion/b/ref=dp_bc_1?ie=UTF8&node=7141123011"
        },
        {
          "id": "7147441011",
          "name": "Men",
          "link": "https://amazon.com/Mens-Fashion/b/ref=dp_bc_2?ie=UTF8&node=7147441011"
        },
        ...
      ],
      "currency": "$",
      "product_byline": "Visit the Amazon Essentials Store",
      "product_byline_link": "https://www.amazon.com/stores/AmazonEssentials/page/F8FB6F3C-F896-455C-BC52-7879F4CEF0CF?is_byline_deeplink=true&deeplink=F8FB6F3C-F896-455C-BC52-7879F4CEF0CF&redirect_store_id=F8FB6F3C-F896-455C-BC52-7879F4CEF0CF&lp_asin=B0BNC23L6C&ref_=ast_bln&store_ref=bl_ast_dp_brandLogo_sto",
      "product_byline_links": [
        "https://www.amazon.com/stores/AmazonEssentials/page/F8FB6F3C-F896-455C-BC52-7879F4CEF0CF?is_byline_deeplink=true&deeplink=F8FB6F3C-F896-455C-BC52-7879F4CEF0CF&redirect_store_id=F8FB6F3C-F896-455C-BC52-7879F4CEF0CF&lp_asin=B0BNC23L6C&ref_=ast_bln&store_ref=bl_ast_dp_brandLogo_sto"
      ],
      "product_star_rating": "4.3",
      "product_num_ratings": 325,
      "product_url": "https://amazon.com/dp/B0BNBR5XC4",
      "product_slug": "Amazon-Essentials-Mens-Derby-Shoe",
      "product_photos": [
        "https://m.media-amazon.com/images/I/81tfIOzeVVL._AC_SX625_.jpg",
        "https://m.media-amazon.com/images/I/81tfIOzeVVL._AC_SX395_.jpg",
        "https://m.media-amazon.com/images/I/81tfIOzeVVL._AC_SX535_.jpg",
        ...
      ],
      "about_product": [
        "COMFORT AND FIT: These plain-toe derby shoes have a padded insole for added comfort and lace-up closure for adjustability.",
        "MATERIAL: Amazon Essentials shoes are made from high-quality alternative leather materials. This style has a faux calfskin upper and is lined in faux leather.",
        ...
      ],
      "product_description": "Classic and versatile plain toe lace-up derby designed for daily wear and superior fit. Crafted with a leather-like material upper with soft and smooth touch.",
      "product_videos": [
        {
          "id": "amzn1.vse.video.069bd87352ca45ed8fed41349e2ff96a",
          "title": "360 Degree View",
          "video_url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/3ed8b3d3-c80f-4dfc-b75d-3ea0082c4619/default.jobtemplate.hls.m3u8",
          "thumbnail_url": "https://m.media-amazon.com/images/I/51TYKTkfD8L._CR0,0,640,361_SR342,193_.jpg",
          "product_asin": "B0BNC23L6C",
          "parent_asin": "B0BNC23L6C",
          "video_width": "640",
          "video_height": "640"
        }
      ],
      "product_num_offers": null,
      "product_availability": null,
      "is_best_seller": true,
      "is_amazon_choice": false,
      "is_prime": true,
      "climate_pledge_friendly": false,
      "sales_volume": null,
      "primary_delivery_time": null,
      "product_details": [
        {
          "name": "Fabric type",
          "value": "100% Synthetic"
        },
        {
          "name": "Origin",
          "value": "Imported"
        },
        ...
      ],
      "customers_say": "Customers find these derby shoes to be a good value for the price, with positive feedback about their style and color. The build quality and comfort receive mixed reviews - while some find them durable and soft, others report poor construction and discomfort. The fit is also mixed, with some saying they fit great while others note they run about half a size too big.",
      "product_variations": {
        "color": [
          {
            "label": "Black",
            "asin": "B0BNBYRYNC",
            "image": "https://m.media-amazon.com/images/I/31MvFnAeKKL._SS_.jpg"
          },
          {
            "label": "Dark Brown",
            "asin": "B0BNBV35Q6",
            "image": "https://m.media-amazon.com/images/I/317PcNhFJLL._SS_.jpg"
          },
          {
            "label": "Black Dark Caramel Faux Leather",
            "asin": "B0BNBRMKTF",
            "image": "https://m.media-amazon.com/images/I/31omLDjHxqL._SS_.jpg"
          }
        ],
        "size": [
          {
            "label": "7",
            "asin": "B0BNBR5XC4"
          },
          {
            "label": "7.5",
            "asin": "B0BNBYW6HH"
          },
          ...
        ]
      },
      "all_product_variations": {
        "B0BNBV3FMT": [
          "12",
          "Dark Brown"
        ],
        "B0BNBS1JRR": [
          "11",
          "Black"
        ],
        ...
      },
      "product_variations_dimensions": [
        "size",
        "color"
      ]
    }
  }
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (422, Validation Failed):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/products/details

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
asin optional string

10-character Amazon ASIN. Send either asin or url; the request returns HTTP 400 if neither one yields an ASIN. Example: B07ZPKBL9V

url optional string

Full Amazon product URL that contains /dp/{ASIN}. It takes precedence over asin, and the page at that URL is fetched as is, so language is ignored.

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US, or to the marketplace in url when a URL is sent; use UK for the United Kingdom. Example: US

language optional string

Locale code for the Amazon page. Defaults to the marketplace's first language and is ignored when url is set. Supported values:

  • US: en_US, es_US
  • AU: en_AU
  • BR: pt_BR
  • CA: en_CA, fr_CA
  • FR: fr_FR, en_GB
  • DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK
  • IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN
  • IT: it_IT, en_GB
  • MX: es_MX
  • NL: nl_NL, en_GB
  • SG: en_SG
  • ES: es_ES, pt_PT, en_GB
  • TR: tr_TR
  • AE: en_AE, ar_AE
  • UK: en_US
  • ZA, NG, IE: en_US
  • JP: ja_JP, en_US, zh_CN
  • SA: ar_AE, en_AE
  • PL: pl_PL
  • SE: sv_SE, en_GB
  • BE: fr_BE, nl_BE, en_GB
  • EG: ar_AE, en_AE

GET /v1/products/batch

requires authentication

Returns full product details, in the same format as the product details endpoint, for up to 5 ASINs in one request. An ASIN whose page cannot be read comes back as an entry with only asin and error instead of product fields.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/products/batch'
params = {
  'asins': 'B07ZPKBL9V,B0DM3WFBCC',
  'country': 'US',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/products/batch';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'asins' => 'B07ZPKBL9V,B0DM3WFBCC',
            'country' => 'US',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/products/batch"
);

const params = {
    "asins": "B07ZPKBL9V,B0DM3WFBCC",
    "country": "US",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/products/batch?asins=B07ZPKBL9V%2CB0DM3WFBCC&country=US" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
        "version": "v1.0",
        "status": 200,
        "copywrite": "https://steadyapi.com",
        "marketplace": "https://amazon.com",
        "country": "US",
        "count": 1
    },
    "body": [
        {
            "asin": "B0DM3WFBCC",
            "product_title": "Brooks Men’s Revel 8 Running Shoe",
            "product_price": "64.95",
            "product_original_price": "$99.95",
            "unit_price": null,
            "product_price_max": null,
            "minimum_order_quantity": null,
            "categories": [
                {
                    "id": "7141123011",
                    "name": "Clothing, Shoes & Jewelry",
                    "link": "https://amazon.com/amazon-fashion/b/ref=dp_bc_1?ie=UTF8&node=7141123011"
                }
            ],
            "currency": "$",
            "product_byline": "Visit the Brooks Store",
            "product_byline_link": "https://www.amazon.com/stores/Brooks/page/B6834DFA-396F-4E38-98F6-3D2739393271?lp_asin=B0DM3WFBCC&ref_=ast_bln&store_ref=bl_ast_dp_brandlogo_sto",
            "product_byline_links": [
                "https://www.amazon.com/stores/Brooks/page/B6834DFA-396F-4E38-98F6-3D2739393271?lp_asin=B0DM3WFBCC&ref_=ast_bln&store_ref=bl_ast_dp_brandlogo_sto"
            ],
            "product_star_rating": 4.4,
            "product_num_ratings": 1694,
            "product_url": "https://amazon.com/dp/B0DM3WFBCC",
            "product_slug": null,
            "product_photos": [
                "https://m.media-amazon.com/images/I/717PUcn8lXL._AC_SY395_.jpg"
            ],
            "about_product": [
                "THIS MEN'S SHOE IS FOR: Runners or walkers focused on improving their fitness, the Revel 8 offers a smooth, distracti...",
                "ENGINEERED FOR COMFORT: Adaptable DNA Loft v2 cushioning provides underfoot comfort for any activity that adapts to y..."
            ],
            "product_description": null,
            "product_videos": [],
            "product_num_offers": null,
            "product_availability": "In Stock",
            "is_best_seller": true,
            "is_amazon_choice": false,
            "is_prime": false,
            "climate_pledge_friendly": false,
            "limited_time_deal": false,
            "sales_volume": "300+ bought in past month",
            "primary_delivery_time": "Monday, October 5",
            "product_details": [
                {
                    "name": "Origin",
                    "value": "Imported"
                },
                {
                    "name": "Sole material",
                    "value": "Rubber"
                },
                {
                    "name": "Outer material",
                    "value": "Mesh"
                }
            ],
            "customers_say": null,
            "product_variations": {
                "color": [
                    {
                        "label": "Black/Black",
                        "asin": "B0DM3GT6KP",
                        "image": "https://m.media-amazon.com/images/I/31cC8fMeGvL._SS_.jpg"
                    }
                ],
                "size": [
                    {
                        "label": "7",
                        "asin": "B0DM3M5W87"
                    }
                ]
            },
            "all_product_variations": {
                "B0DM3HBP9Q": [
                    "12.5 Wide",
                    "Primer Grey/Blackened Pearl"
                ],
                "B0DM3FV9YB": [
                    "10",
                    "White/Black/Oak Buff"
                ]
            },
            "product_variations_dimensions": [
                "size",
                "color"
            ]
        }
    ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (422, Validation Failed):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/products/batch

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
asins required string

Comma-separated ASINs. Entries that are not 10 letters or digits are dropped, duplicates are removed, and only the first 5 are used. If none are valid, the request fails with "No valid ASINs provided." Example: B07ZPKBL9V,B0DM3WFBCC

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: US

language optional string

Locale code for the Amazon pages, such as en_US. A value the marketplace does not support falls back to its first language.

GET /v1/products/variations

requires authentication

Returns a product's variation options (such as color and size), the dimension names, and every child ASIN with its value for each dimension. Use it to find the ASIN of one specific variant.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/products/variations'
params = {
  'asin': 'B0DM3WFBCC',
  'country': 'US',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/products/variations';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'asin' => 'B0DM3WFBCC',
            'country' => 'US',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/products/variations"
);

const params = {
    "asin": "B0DM3WFBCC",
    "country": "US",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/products/variations?asin=B0DM3WFBCC&country=US" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
        "version": "v1.0",
        "status": 200,
        "copywrite": "https://steadyapi.com",
        "marketplace": "https://amazon.com",
        "country": "US",
        "asin": "B0DM3WFBCC"
    },
    "body": {
        "asin": "B0DM3WFBCC",
        "product_title": "Brooks Men’s Revel 8 Running Shoe",
        "dimensions": [
            "size",
            "color"
        ],
        "variations": {
            "color": [
                {
                    "label": "Black/Black",
                    "asin": "B0DM3GT6KP",
                    "image": "https://m.media-amazon.com/images/I/31cC8fMeGvL._SS_.jpg"
                },
                {
                    "label": "Black/Excalibur/Orange",
                    "asin": "B0DM3WD1GW",
                    "image": "https://m.media-amazon.com/images/I/31B-DScn3xL._SS_.jpg"
                },
                {
                    "label": "Black/Grey/White",
                    "asin": "B0DM3G6FRQ",
                    "image": "https://m.media-amazon.com/images/I/41NVrILCfJL._SS_.jpg"
                }
            ],
            "size": [
                {
                    "label": "7",
                    "asin": "B0DM3M5W87"
                },
                {
                    "label": "7 Wide",
                    "asin": "B0DM39WHKZ"
                },
                {
                    "label": "7.5",
                    "asin": "B0DM3YRWHY"
                }
            ]
        },
        "all_variations": [
            {
                "asin": "B0DM3HBP9Q",
                "size": "12.5 Wide",
                "color": "Primer Grey/Blackened Pearl"
            },
            {
                "asin": "B0DM3FV9YB",
                "size": "10",
                "color": "White/Black/Oak Buff"
            },
            {
                "asin": "B0F4LCR7CV",
                "size": "9",
                "color": "Coconut/Gray Mist/Sand"
            }
        ]
    }
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (422, Validation Failed):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/products/variations

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
asin required string

10-character Amazon ASIN of the product. Example: B0DM3WFBCC

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: US

language optional string

Locale code for the Amazon page, such as en_US. A value the marketplace does not support falls back to its first language.

GET /v1/products/price

requires authentication

Returns a short price record for up to 5 ASINs: title, current price, list price, currency, availability, star rating, and rating count. Use it instead of the batch endpoint when you only need prices and stock status.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/products/price'
params = {
  'asins': 'B07ZPKBL9V,B0DM3WFBCC',
  'country': 'US',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/products/price';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'asins' => 'B07ZPKBL9V,B0DM3WFBCC',
            'country' => 'US',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/products/price"
);

const params = {
    "asins": "B07ZPKBL9V,B0DM3WFBCC",
    "country": "US",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/products/price?asins=B07ZPKBL9V%2CB0DM3WFBCC&country=US" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
        "version": "v1.0",
        "status": 200,
        "copywrite": "https://steadyapi.com",
        "marketplace": "https://amazon.com",
        "country": "US",
        "count": 2
    },
    "body": [
        {
            "asin": "B07ZPKBL9V",
            "product_title": "Apple iPhone 11, 64GB, PRODUCT RED - Unlocked (Renewed)",
            "product_price": "172.95",
            "product_original_price": null,
            "currency": "$",
            "product_availability": "In Stock",
            "product_star_rating": 4.2,
            "product_num_ratings": 60079
        },
        {
            "asin": "B0DM3WFBCC",
            "product_title": "Brooks Men’s Revel 8 Running Shoe",
            "product_price": "64.95",
            "product_original_price": "$99.95",
            "currency": "$",
            "product_availability": "In Stock",
            "product_star_rating": 4.4,
            "product_num_ratings": 1694
        }
    ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (422, Validation Failed):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/products/price

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
asins required string

One ASIN or a comma-separated list. Entries that are not 10 letters or digits are dropped, duplicates are removed, and only the first 5 are used. Example: B07ZPKBL9V,B0DM3WFBCC

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: US

language optional string

Locale code for the Amazon pages, such as en_US. A value the marketplace does not support falls back to its first language.

GET /v1/review

requires authentication

Returns the review data shown on a product page: average rating, total review count, star distribution, the "customers say" summary, and the top reviews with reviewer, rating, date, verified-purchase flag, variant, and text. Only the reviews on the product page are returned; there is no pagination.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/products/reviews'
params = {
  'asin': 'B07ZPKBL9V',
  'country': 'US',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/products/reviews';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'asin' => 'B07ZPKBL9V',
            'country' => 'US',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/products/reviews"
);

const params = {
    "asin": "B07ZPKBL9V",
    "country": "US",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/products/reviews?asin=B07ZPKBL9V&country=US" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
      "version": "v1.0",
      "status": 200,
      "copywrite": "https://steadyapi.com",
      "marketplace": "https://amazon.com",
      "asin": "B0BNBR5XC4",
      "country": "US"
    },
    "body": {
      "asin": "B0BNBR5XC4",
      "product_title": "Amazon Essentials Men's Derby Shoe",
      "product_price": "$34.50",
      "product_original_price": null,
      "unit_price": null,
      "product_price_max": null,
      "minimum_order_quantity": null,
      "categories": [
        {
          "id": "7141123011",
          "name": "Clothing, Shoes & Jewelry",
          "link": "https://amazon.com/amazon-fashion/b/ref=dp_bc_1?ie=UTF8&node=7141123011"
        },
        {
          "id": "7147441011",
          "name": "Men",
          "link": "https://amazon.com/Mens-Fashion/b/ref=dp_bc_2?ie=UTF8&node=7147441011"
        },
        ...
      ],
      "currency": "$",
      "product_byline": "Visit the Amazon Essentials Store",
      "product_byline_link": "https://www.amazon.com/stores/AmazonEssentials/page/F8FB6F3C-F896-455C-BC52-7879F4CEF0CF?is_byline_deeplink=true&deeplink=F8FB6F3C-F896-455C-BC52-7879F4CEF0CF&redirect_store_id=F8FB6F3C-F896-455C-BC52-7879F4CEF0CF&lp_asin=B0BNC23L6C&ref_=ast_bln&store_ref=bl_ast_dp_brandLogo_sto",
      "product_byline_links": [
        "https://www.amazon.com/stores/AmazonEssentials/page/F8FB6F3C-F896-455C-BC52-7879F4CEF0CF?is_byline_deeplink=true&deeplink=F8FB6F3C-F896-455C-BC52-7879F4CEF0CF&redirect_store_id=F8FB6F3C-F896-455C-BC52-7879F4CEF0CF&lp_asin=B0BNC23L6C&ref_=ast_bln&store_ref=bl_ast_dp_brandLogo_sto"
      ],
      "product_star_rating": "4.3",
      "product_num_ratings": 325,
      "product_url": "https://amazon.com/dp/B0BNBR5XC4",
      "product_slug": "Amazon-Essentials-Mens-Derby-Shoe",
      "product_photos": [
        "https://m.media-amazon.com/images/I/81tfIOzeVVL._AC_SX625_.jpg",
        "https://m.media-amazon.com/images/I/81tfIOzeVVL._AC_SX395_.jpg",
        "https://m.media-amazon.com/images/I/81tfIOzeVVL._AC_SX535_.jpg",
        ...
      ],
      "about_product": [
        "COMFORT AND FIT: These plain-toe derby shoes have a padded insole for added comfort and lace-up closure for adjustability.",
        "MATERIAL: Amazon Essentials shoes are made from high-quality alternative leather materials. This style has a faux calfskin upper and is lined in faux leather.",
        ...
      ],
      "product_description": "Classic and versatile plain toe lace-up derby designed for daily wear and superior fit. Crafted with a leather-like material upper with soft and smooth touch.",
      "product_videos": [
        {
          "id": "amzn1.vse.video.069bd87352ca45ed8fed41349e2ff96a",
          "title": "360 Degree View",
          "video_url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/3ed8b3d3-c80f-4dfc-b75d-3ea0082c4619/default.jobtemplate.hls.m3u8",
          "thumbnail_url": "https://m.media-amazon.com/images/I/51TYKTkfD8L._CR0,0,640,361_SR342,193_.jpg",
          "product_asin": "B0BNC23L6C",
          "parent_asin": "B0BNC23L6C",
          "video_width": "640",
          "video_height": "640"
        }
      ],
      "product_num_offers": null,
      "product_availability": null,
      "is_best_seller": true,
      "is_amazon_choice": false,
      "is_prime": true,
      "climate_pledge_friendly": false,
      "sales_volume": null,
      "primary_delivery_time": null,
      "product_details": [
        {
          "name": "Fabric type",
          "value": "100% Synthetic"
        },
        {
          "name": "Origin",
          "value": "Imported"
        },
        ...
      ],
      "customers_say": "Customers find these derby shoes to be a good value for the price, with positive feedback about their style and color. The build quality and comfort receive mixed reviews - while some find them durable and soft, others report poor construction and discomfort. The fit is also mixed, with some saying they fit great while others note they run about half a size too big.",
      "product_variations": {
        "color": [
          {
            "label": "Black",
            "asin": "B0BNBYRYNC",
            "image": "https://m.media-amazon.com/images/I/31MvFnAeKKL._SS_.jpg"
          },
          {
            "label": "Dark Brown",
            "asin": "B0BNBV35Q6",
            "image": "https://m.media-amazon.com/images/I/317PcNhFJLL._SS_.jpg"
          },
          {
            "label": "Black Dark Caramel Faux Leather",
            "asin": "B0BNBRMKTF",
            "image": "https://m.media-amazon.com/images/I/31omLDjHxqL._SS_.jpg"
          }
        ],
        "size": [
          {
            "label": "7",
            "asin": "B0BNBR5XC4"
          },
          {
            "label": "7.5",
            "asin": "B0BNBYW6HH"
          },
          ...
        ]
      },
      "all_product_variations": {
        "B0BNBV3FMT": [
          "12",
          "Dark Brown"
        ],
        "B0BNBS1JRR": [
          "11",
          "Black"
        ],
        ...
      },
      "product_variations_dimensions": [
        "size",
        "color"
      ]
    }
  }
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (422, Validation Failed):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/products/reviews

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
asin required string

10-character Amazon ASIN of the product. Example: B07ZPKBL9V

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: US

language optional string

Locale code for the Amazon page. A value the selected marketplace does not support falls back to that marketplace's first language. Supported values:

  • US: en_US, es_US
  • AU: en_AU
  • BR: pt_BR
  • CA: en_CA, fr_CA
  • FR: fr_FR, en_GB
  • DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK
  • IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN
  • IT: it_IT, en_GB
  • MX: es_MX
  • NL: nl_NL, en_GB
  • SG: en_SG
  • ES: es_ES, pt_PT, en_GB
  • TR: tr_TR
  • AE: en_AE, ar_AE
  • UK: en_US
  • ZA, NG, IE: en_US
  • JP: ja_JP, en_US, zh_CN
  • SA: ar_AE, en_AE
  • PL: pl_PL
  • SE: sv_SE, en_GB
  • BE: fr_BE, nl_BE, en_GB
  • EG: ar_AE, en_AE

GET /v1/similar

requires authentication

Returns the products Amazon recommends next to a given product, each with ASIN, title, image, price, URL, rating, and review count.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/products/similar'
params = {
  'asin': 'B07ZPKBL9V',
  'country': 'US',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/products/similar';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'asin' => 'B07ZPKBL9V',
            'country' => 'US',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/products/similar"
);

const params = {
    "asin": "B07ZPKBL9V",
    "country": "US",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/products/similar?asin=B07ZPKBL9V&country=US" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "marketplace": "https://amazon.com",
    "country": "US",
    "currency": "USD",
    "asin": "B09SM24S8C"
  },
  "body": [
    {
      "asin": "B09Z8P34NM",
      "title": "SAMSUNG Galaxy A13 LTE, Factory Unlocked Smartphone, Android Cell Phone, Water Resistant, 50MP Camera, US Version, 32GB, Black (Renewed)",
      "image": "https://m.media-amazon.com/images/I/61IX%2B1qw35L._AA160_.jpg",
      "price": "$106.02",
      "url": "https://www.amazon.com/dp/B09Z8P34NM/ref=aod_recs_desktop_prsubs_0",
      "rating": "4.1 out of 5 stars",
      "reviews": 941
    },
    { ... }
  ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (422, Validation Failed):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/products/similar

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
asin required string

10-character Amazon ASIN of the product. Example: B07ZPKBL9V

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: US

language optional string

Locale code for the Amazon page. A value the selected marketplace does not support falls back to that marketplace's first language. Supported values:

  • US: en_US, es_US
  • AU: en_AU
  • BR: pt_BR
  • CA: en_CA, fr_CA
  • FR: fr_FR, en_GB
  • DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK
  • IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN
  • IT: it_IT, en_GB
  • MX: es_MX
  • NL: nl_NL, en_GB
  • SG: en_SG
  • ES: es_ES, pt_PT, en_GB
  • TR: tr_TR
  • AE: en_AE, ar_AE
  • UK: en_US
  • ZA, NG, IE: en_US
  • JP: ja_JP, en_US, zh_CN
  • SA: ar_AE, en_AE
  • PL: pl_PL
  • SE: sv_SE, en_GB
  • BE: fr_BE, nl_BE, en_GB
  • EG: ar_AE, en_AE

GET /v1/offers

requires authentication

Returns the seller offers listed for a product, each with price, condition, ships-from, seller name and ID, seller rating, delivery price, and delivery date. Without filters, offers in every condition are included.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/products/offers'
params = {
  'asin': 'B09SM24S8C',
  'country': 'US',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/products/offers';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'asin' => 'B09SM24S8C',
            'country' => 'US',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/products/offers"
);

const params = {
    "asin": "B09SM24S8C",
    "country": "US",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/products/offers?asin=B09SM24S8C&country=US" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "marketplace": "https://amazon.com",
    "country": "US",
    "currency": "USD",
    "asin": "B09TDP1HCV",
    "condition": "all",
    "delivery": "prime"
  },
  "body": [
    {
      "product_price": "$24.07",
      "product_original_price": null,
      "product_condition": "Used - Very Good",
      "ships_from": "Amazon.com",
      "seller": "Yuanchina",
      "seller_id": "A531LOZXINYGL",
      "seller_link": "https://www.amazon.com/gp/aag/main?ie=UTF8&seller=A531LOZXINYGL&isAmazonFulfilled=1&asin=B09TDP1HCV&ref_=olp_merch_name_3",
      "seller_star_rating": null,
      "seller_star_rating_info": null,
      "currency": "USD",
      "delivery_price": "FREE",
      "delivery_time": "Monday, July 21"
    },
    { ... }
  ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (422, Validation Failed):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/products/offers

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
asin required string

10-character Amazon ASIN of the product. Example: B09SM24S8C

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: US

condition optional string

Offer condition: new, or one of the used grades like_new, very_good, good, acceptable. Omit it to include all conditions.

delivery optional string

Delivery type: prime for Prime-eligible offers or free for free shipping. Omit it to include both.

language optional string

Locale code for the Amazon page. A value the selected marketplace does not support falls back to that marketplace's first language. Supported values:

  • US: en_US, es_US
  • AU: en_AU
  • BR: pt_BR
  • CA: en_CA, fr_CA
  • FR: fr_FR, en_GB
  • DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK
  • IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN
  • IT: it_IT, en_GB
  • MX: es_MX
  • NL: nl_NL, en_GB
  • SG: en_SG
  • ES: es_ES, pt_PT, en_GB
  • TR: tr_TR
  • AE: en_AE, ar_AE
  • UK: en_US
  • ZA, NG, IE: en_US
  • JP: ja_JP, en_US, zh_CN
  • SA: ar_AE, en_AE
  • PL: pl_PL
  • SE: sv_SE, en_GB
  • BE: fr_BE, nl_BE, en_GB
  • EG: ar_AE, en_AE

Deals & Rankings

Amazon deals, coupon deals, and the best-seller and new-release rankings for a category.

GET /v1/with-coupons

requires authentication

Returns Amazon deals that come with a coupon in one department, 30 per page. Each item has ASIN, title, price, image, URL, coupon code and text, discount percentage, and savings amount, and the response also lists related departments with their IDs.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/deals/with-coupons'
params = {
  'category_id': '3408271',
  'low_price': '20',
  'high_price': '200',
  'low_discount': '5',
  'high_discount': '40',
  'country': 'US',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/deals/with-coupons';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'category_id' => '3408271',
            'low_price' => '20',
            'high_price' => '200',
            'low_discount' => '5',
            'high_discount' => '40',
            'country' => 'US',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/deals/with-coupons"
);

const params = {
    "category_id": "3408271",
    "low_price": "20",
    "high_price": "200",
    "low_discount": "5",
    "high_discount": "40",
    "country": "US",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/deals/with-coupons?category_id=3408271&low_price=20&high_price=200&low_discount=5&high_discount=40&country=US" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "marketplace": "https://amazon.com",
    "country": "US",
    "currency": "USD",
    "language": "en_US",
    "total": 416,
    "category_id": "3408271",
    "min_rating_4": "true",
    "high_discount": "20",
    "page": "2"
  },
  "body": {
    "related_categories": [
      {
        "name": "Sports & Outdoors",
        "category_id": "3375301"
      },
      {
        "name": "Exercise & Fitness",
        "category_id": "3407731"
      },
      { ... }
    ],
    "items": [
      {
        "asin": "B0F21188SY",
        "title": "OPPSDECOR 6 in 1 660lbs Weight Bench with Leg Extension and Leg Curl, Foldable Bench Press Set and Squat Barbell Rack with Preacher Curl, Adjustable Workout Bench for Home Gym Strength Training PXZXYX1",
        "price": "189.98",
        "currency": "USD",
        "image": "https://m.media-amazon.com/images/I/71BR3bPhCnL._AC_SL1000_.jpg",
        "coupon_code": "A2MRM7WQ8GIVP9",
        "coupon_label": "Save 5%",
        "coupon_text": " with coupon (some sizes/colors)",
        "discount_percent": {
          "displayString": "5%",
          "value": 5
        },
        "savings_amount": {
          "amount": "9.50",
          "currencyCode": "USD"
        },
        "url": "https://www.amazon.com/OPPSDECOR-Extension-Foldable-Preacher-Adjustable/dp/B0F21188SY",
        "variation_labels": [
          "Red",
          "Scarlet",
          "Vermilionblack"
        ]
      },
      { ... }
    ]
  }
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (422, Validation Failed):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/deals/with-coupons

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
category_id required string

Amazon deals department ID, up to 20 characters. Department IDs appear under related_categories in deals responses. Example: 3408271

page optional integer

Results page; each page holds 30 deals. Defaults to 1.

low_price optional integer

Minimum price as a whole number in the marketplace currency. If only high_price is set, the minimum is 0. Example: 20

high_price optional integer

Maximum price as a whole number in the marketplace currency. If only low_price is set, the maximum is 5000. Example: 200

low_discount optional integer

Minimum discount percentage. If only high_discount is set, the minimum is 0. Example: 5

high_discount optional integer

Maximum discount percentage. If only low_discount is set, the maximum is 40. Example: 40

min_rating_4 optional string

Set to true to return only products rated 4 stars and up. Omit it to turn the filter off, because any value, including false, turns it on.

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: US

language optional string

Locale code for the Amazon page. A value the selected marketplace does not support falls back to that marketplace's first language. Supported values:

  • US: en_US, es_US
  • AU: en_AU
  • BR: pt_BR
  • CA: en_CA, fr_CA
  • FR: fr_FR, en_GB
  • DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK
  • IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN
  • IT: it_IT, en_GB
  • MX: es_MX
  • NL: nl_NL, en_GB
  • SG: en_SG
  • ES: es_ES, pt_PT, en_GB
  • TR: tr_TR
  • AE: en_AE, ar_AE
  • UK: en_US
  • ZA, NG, IE: en_US
  • JP: ja_JP, en_US, zh_CN
  • SA: ar_AE, en_AE
  • PL: pl_PL
  • SE: sv_SE, en_GB
  • BE: fr_BE, nl_BE, en_GB
  • EG: ar_AE, en_AE

requires authentication

Returns the deals on one Amazon deals page, such as Trending, Outlet, or a department, 30 per page. Each item has ASIN, title, price, image, URL, discount percentage, and savings amount, and the response also lists related departments with their IDs. Filter by Prime eligibility, price range, discount range, or a 4-star minimum rating.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/deals/search'
params = {
  'category_name': 'personal-care',
  'is_prime': 'ratione',
  'low_price': '20',
  'high_price': '200',
  'low_discount': '5',
  'high_discount': '40',
  'country': 'US',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/deals/search';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'category_name' => 'personal-care',
            'is_prime' => 'ratione',
            'low_price' => '20',
            'high_price' => '200',
            'low_discount' => '5',
            'high_discount' => '40',
            'country' => 'US',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/deals/search"
);

const params = {
    "category_name": "personal-care",
    "is_prime": "ratione",
    "low_price": "20",
    "high_price": "200",
    "low_discount": "5",
    "high_discount": "40",
    "country": "US",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/deals/search?category_name=personal-care&is_prime=ratione&low_price=20&high_price=200&low_discount=5&high_discount=40&country=US" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "marketplace": "https://amazon.com",
    "country": "US",
    "currency": "USD",
    "language": "en_US",
    "total": 9,
    "category_name": "personal-care",
    "is_prime": "true",
    "min_rating_4": "true",
    "high_discount": "20",
    "page": "1"
  },
  "body": {
    "related_categories": [
      {
        "name": "Health & Household",
        "category_id": "3760931"
      }
    ],
    "items": [
      {
        "asin": "B0CSYLPHM8",
        "title": "cotsoco Hand Massager with Heat and Compression for Arthritis and Carpal Tunnel, Birthday Gifts for Women Mom Men,White, Gift for Birthday",
        "price": "39.99",
        "currency": "USD",
        "image": "https://m.media-amazon.com/images/I/61oCyy8tRaL._AC_SL1000_.jpg",
        "coupon_code": null,
        "coupon_info": "17% off",
        "coupon_text": null,
        "discount_percent": {
          "displayString": "17%",
          "value": 17
        },
        "savings_amount": {
          "amount": "8.0",
          "currencyCode": "USD"
        },
        "url": "https://www.amazon.com/cotsoco-Compression-Arthritis-Christmas-Thanksgiving/dp/B0CSYLPHM8",
        "variation_labels": [
          "Black",
          "Pink",
          "White"
        ]
      },
      { ... }
    ]
  }
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (422, Validation Failed):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

GET /v1/best-sellers

requires authentication

Returns Amazon's Best Sellers ranking for one category, with rank, ASIN, title, URL, image, star rating, rating count, and price for each product.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/rankings/best-sellers'
params = {
  'category': 'beauty',
  'country': 'US',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/rankings/best-sellers';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'category' => 'beauty',
            'country' => 'US',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/rankings/best-sellers"
);

const params = {
    "category": "beauty",
    "country": "US",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/rankings/best-sellers?category=beauty&country=US" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "marketplace": "https://amazon.com",
    "country": "US",
    "currency": "USD",
    "language": "en_US",
    "category": "baby-products/166777011",
    "page": "1"
  },
  "body": [
    {
      "asin": "B015XBYDLM",
      "title": "Dr. Brown’s Natural Flow Level 2 Narrow Baby Bottle Silicone Nipple, Medium Flow, 3m+, 100% Silicone Bottle Nipple, 6 Count",
      "url": "https://www.amazon.com/Dr-Browns-Original-Nipple-Level/dp/B015XBYDLM/ref=zg_bs_g_166777011_d_sccl_1/142-3331457-8966669?psc=1",
      "image": "https://images-na.ssl-images-amazon.com/images/I/71bKME-MvxL._AC_UL300_SR300,200_.jpg",
      "rating": 4.8,
      "rating_count": 92665,
      "price": "$9.97",
      "rank": "#1"
    },
    { ... }
  ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (422, Validation Failed):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/rankings/best-sellers

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
category required string

Category path from an Amazon Best Sellers URL. For https://www.amazon.com/best-sellers/zgbs/beauty use beauty; a subcategory path such as beauty/11056591 also works. Letters, digits, hyphens, and slashes only, up to 100 characters. Example: beauty

page optional integer

Ranking page number. Defaults to 1.

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: US

language optional string

Locale code for the Amazon page. A value the selected marketplace does not support falls back to that marketplace's first language. Supported values:

  • US: en_US, es_US
  • AU: en_AU
  • BR: pt_BR
  • CA: en_CA, fr_CA
  • FR: fr_FR, en_GB
  • DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK
  • IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN
  • IT: it_IT, en_GB
  • MX: es_MX
  • NL: nl_NL, en_GB
  • SG: en_SG
  • ES: es_ES, pt_PT, en_GB
  • TR: tr_TR
  • AE: en_AE, ar_AE
  • UK: en_US
  • ZA, NG, IE: en_US
  • JP: ja_JP, en_US, zh_CN
  • SA: ar_AE, en_AE
  • PL: pl_PL
  • SE: sv_SE, en_GB
  • BE: fr_BE, nl_BE, en_GB
  • EG: ar_AE, en_AE

GET /v1/new-releases

requires authentication

Returns Amazon's Hot New Releases ranking for one category, in the same format as the best sellers endpoint.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/rankings/new-releases'
params = {
  'category': 'beauty',
  'country': 'US',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/rankings/new-releases';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'category' => 'beauty',
            'country' => 'US',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/rankings/new-releases"
);

const params = {
    "category": "beauty",
    "country": "US",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/rankings/new-releases?category=beauty&country=US" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "marketplace": "https://amazon.com",
    "country": "US",
    "currency": "USD",
    "language": "en_US",
    "category": "baby-products/166777011",
    "page": "1"
  },
  "body": [
    {
      "asin": "B015XBYDLM",
      "title": "Dr. Brown’s Natural Flow Level 2 Narrow Baby Bottle Silicone Nipple, Medium Flow, 3m+, 100% Silicone Bottle Nipple, 6 Count",
      "url": "https://www.amazon.com/Dr-Browns-Original-Nipple-Level/dp/B015XBYDLM/ref=zg_bs_g_166777011_d_sccl_1/145-5930051-3318760?psc=1",
      "image": "https://images-na.ssl-images-amazon.com/images/I/71bKME-MvxL._AC_UL300_SR300,200_.jpg",
      "rating": 4.8,
      "rating_count": 92665,
      "price": "$9.97",
      "rank": "#1"
    },
    { ... }
  ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (422, Validation Failed):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/rankings/new-releases

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
category required string

Category path from an Amazon ranking URL. For https://www.amazon.com/new-releases/zgbs/beauty use beauty; a subcategory path such as beauty/11056591 also works. Letters, digits, hyphens, and slashes only, up to 100 characters. Example: beauty

page optional integer

Ranking page number. Defaults to 1.

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: US

language optional string

Locale code for the Amazon page. A value the selected marketplace does not support falls back to that marketplace's first language. Supported values:

  • US: en_US, es_US
  • AU: en_AU
  • BR: pt_BR
  • CA: en_CA, fr_CA
  • FR: fr_FR, en_GB
  • DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK
  • IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN
  • IT: it_IT, en_GB
  • MX: es_MX
  • NL: nl_NL, en_GB
  • SG: en_SG
  • ES: es_ES, pt_PT, en_GB
  • TR: tr_TR
  • AE: en_AE, ar_AE
  • UK: en_US
  • ZA, NG, IE: en_US
  • JP: ja_JP, en_US, zh_CN
  • SA: ar_AE, en_AE
  • PL: pl_PL
  • SE: sv_SE, en_GB
  • BE: fr_BE, nl_BE, en_GB
  • EG: ar_AE, en_AE

Sellers

Public seller data from Amazon: the seller profile page and the products a seller lists.

GET /v1/profile

requires authentication

Returns a seller's public profile: name, logo, storefront link, business name and address, phone number, positive-feedback percentage, and star rating with review counts for the last 30 days, 90 days, 12 months, and lifetime. Fields the seller page does not show come back null or empty.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/seller/profile'
params = {
  'seller_id': 'ARVLBD5MF9H1U',
  'country': 'US',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/seller/profile';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'seller_id' => 'ARVLBD5MF9H1U',
            'country' => 'US',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/seller/profile"
);

const params = {
    "seller_id": "ARVLBD5MF9H1U",
    "country": "US",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/seller/profile?seller_id=ARVLBD5MF9H1U&country=US" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "marketplace": "https://amazon.com",
    "seller_id": "A02211013Q5HP3OMSZC7W",
    "country": "US"
  },
  "body": {
    "name": "MemoryWhiz",
    "store_link": "https://amazon.com/s?ie=UTF8&marketplaceID=ATVPDKIKX0DER&me=A02211013Q5HP3OMSZC7W",
    "logo": "https://m.media-amazon.com/images/I/01inXJbpK2L.gif",
    "business_name": "Alast Corporation",
    "business_address": "20651 GOLDEN SPRINGS DRIVE, Suite 111, Walnut, CA, 91789, US",
    "phone": "909-610-9170",
    "ratings_total_percentage": 100,
    "review_summary": {
      "thirty_days": {
        "rating": 5,
        "count": 117
      },
      { ... }
    },
    "rating": 4.9,
    "ratings_total": 51420
  }
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (422, Validation Failed):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/seller/profile

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
seller_id required string

Amazon seller ID, as shown in the seller= parameter of a seller profile URL, up to 50 characters. Example: ARVLBD5MF9H1U

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: US

language optional string

Locale code for the Amazon page. A value the selected marketplace does not support falls back to that marketplace's first language. Supported values:

  • US: en_US, es_US
  • AU: en_AU
  • BR: pt_BR
  • CA: en_CA, fr_CA
  • FR: fr_FR, en_GB
  • DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK
  • IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN
  • IT: it_IT, en_GB
  • MX: es_MX
  • NL: nl_NL, en_GB
  • SG: en_SG
  • ES: es_ES, pt_PT, en_GB
  • TR: tr_TR
  • AE: en_AE, ar_AE
  • UK: en_US
  • ZA, NG, IE: en_US
  • JP: ja_JP, en_US, zh_CN
  • SA: ar_AE, en_AE
  • PL: pl_PL
  • SE: sv_SE, en_GB
  • BE: fr_BE, nl_BE, en_GB
  • EG: ar_AE, en_AE

GET /v1/products

requires authentication

Returns one page of the products a seller lists on Amazon, in the same format as product search. Accepts the same sort and filter options as product search, so you can narrow a seller's catalog by price, category, condition, Prime eligibility, or rating.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/seller/products'
params = {
  'seller_id': 'A02211013Q5HP3OMSZC7W',
  'country': 'US',
  'sort_by': 'RELEVANCE',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/seller/products';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'seller_id' => 'A02211013Q5HP3OMSZC7W',
            'country' => 'US',
            'sort_by' => 'RELEVANCE',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/seller/products"
);

const params = {
    "seller_id": "A02211013Q5HP3OMSZC7W",
    "country": "US",
    "sort_by": "RELEVANCE",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/seller/products?seller_id=A02211013Q5HP3OMSZC7W&country=US&sort_by=RELEVANCE" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "marketplace": "https://amazon.com",
    "total": 11,
    "seller_id": "A02211013Q5HP3OMSZC7W",
    "low_price": "50",
    "is_prime": "true",
    "min_rating_4": "true",
    "language": "en_US",
    "country": "US",
    "page": "1"
  },
  "body": [
    {
      "asin": "B0DSPYPKRG",
      "product_title": "Raspberry Pi 5 (16GB)",
      "product_price": "$129.99",
      "product_original_price": "$144.99",
      "currency": "USD",
      "product_star_rating": "4.7",
      "product_num_ratings": 82,
      "product_url": "https://amazon.com/dp/B0DSPYPKRG",
      "product_photo": "https://m.media-amazon.com/images/I/71Cc5SOIjIL._AC_UY218_.jpg",
      "product_num_offers": null,
      "product_minimum_offer_price": null,
      "is_best_seller": false,
      "is_amazon_choice": false,
      "is_prime": false,
      "climate_pledge_friendly": false,
      "sales_volume": "1K+ bought in past month",
      "delivery": "FREE delivery Mon, Jul 21",
      "has_variations": false,
      "product_badge": null
    },
    { ... }
  ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/seller/products

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
seller_id required string

Amazon seller ID, as shown in the seller= or me= parameter of a seller URL. Example: A02211013Q5HP3OMSZC7W

page optional integer

Results page, from 1 to 500. Defaults to 1.

country optional string

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: US

sort_by optional string

Sort order: RELEVANCE, LOWEST_PRICE, HIGHEST_PRICE, REVIEWS, NEWEST, or BEST_SELLERS (case-insensitive). Defaults to RELEVANCE. Example: RELEVANCE

low_price optional number

Minimum price in the marketplace currency. Decimals are dropped, so 19.99 is sent as 19.

high_price optional number

Maximum price in the marketplace currency; must be greater than or equal to low_price. Decimals are dropped.

category_id optional string

Numeric Amazon category (browse node) ID, such as 17238450011. The forms n:17238450011, 3A17238450011, and %3A17238450011 copied from a URL like https://www.amazon.com/s?rh=n%3A17238450011 also work. Values that are not numeric after the prefix is removed are ignored.

is_prime optional string

Set to true to return only Prime-eligible items. Allowed: true, false.

min_rating_4 optional string

Set to true to return only items rated 4 stars and up. Allowed: true, false.

condition optional string

Item condition: new, used, or renewed. collectible is accepted but not applied as a filter.

additional_filters optional string

Comma-separated raw Amazon rh refinements added to the query as is, for example p_n_feature_four_browse-bin:123456,p_n_condition-type:6461716011.

language optional string

Locale code for the Amazon page. A value the selected marketplace does not support falls back to that marketplace's first language. Supported values:

  • US: en_US, es_US
  • AU: en_AU
  • BR: pt_BR
  • CA: en_CA, fr_CA
  • FR: fr_FR, en_GB
  • DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK
  • IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN
  • IT: it_IT, en_GB
  • MX: es_MX
  • NL: nl_NL, en_GB
  • SG: en_SG
  • ES: es_ES, pt_PT, en_GB
  • TR: tr_TR
  • AE: en_AE, ar_AE
  • UK: en_US
  • ZA, NG, IE: en_US
  • JP: ja_JP, en_US, zh_CN
  • SA: ar_AE, en_AE
  • PL: pl_PL
  • SE: sv_SE, en_GB
  • BE: fr_BE, nl_BE, en_GB
  • EG: ar_AE, en_AE

Metadata

Reference data for building filters and menus, such as the department list of each Amazon marketplace.

GET /v1/categories

requires authentication

Returns the department list for one Amazon marketplace, with each department's display name and Amazon search-alias ID (for example beauty or stripbooks). The response is served from a stored list, so it does not hit Amazon. These IDs are search aliases, not the numeric node IDs that the category_id filter on product search expects.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/amazon/categories'
params = {
  'country': '0',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/amazon/categories';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'country' => '0',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/amazon/categories"
);

const params = {
    "country": "0",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/amazon/categories?country=0" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
      "version": "v1.0",
      "status": 200,
      "copywrite": "https://steadyapi.com",
      "country": "United States",
      "marketplace": "https://amazon.com",
      "total": 60
    },
    "body": [
      {
        "name": "All Departments",
        "id": "aps"
      },
      {
        "name": "Alexa Skills",
        "id": "alexa-skills"
      },
      { ... }
    ]
  }
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (403, Unauthorized):


{
    "message": "This action is unauthorized."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/amazon/categories

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
country optional integer

Two-letter Amazon marketplace code, case-insensitive. Defaults to US; use UK for the United Kingdom. Example: 0