pricing

Enables you to scrape pricing options from Amazon offer listings using the ScrapeIN service.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Endpoint

The /pricing API endpoint allows you to send a GET request to retrieve your Amazon Offers query. It provides access to information from the offers listing popup window for a specific product on Amazon.

This allows you to gather comprehensive details about the available pricing options, giving you insights into the diverse offers landscape on Amazon.

Authentication

API-KEY. Use your API-KEY for authentication.

GTIN, ISBN, UPC, or EAN numbers

If you have a product code such as GTIN, ISBN, UPC, or EAN, you can use the API to automatically convert it into an ASIN. The ASIN uniquely identifies a product on Amazon. By providing the product code to the API, you can retrieve pricing data for that specific product. To learn more about how to use the API to lookup Amazon product details using GTIN, ISBN, UPC, or EAN codes, you can refer to the provided useful information section. It will provide you with the necessary instructions and details on how to perform the lookup.

📘

Note on Lookup ASIN by GTIN, ISBN, UPC, or EAN

ScrapeIN caches the mapping between GTIN and ASIN for a period of 2 months. If you need to perform a new lookup and suspect that the existing mapping is outdated, you can use the skip_gtin_cache=true request parameter. However, please be aware that using this parameter will deduct 2 requests from your balance instead of the usual 1 request.

Output format

html, json, csv

🚧

Required Parameters

To specify the info about pricing, you have the following options:

  1. Use the asin and amazon_domain parameters together. When using the ASIN, always specify the corresponding Amazon domain, ensuring that you are retrieving information from the correct regional version of Amazon.
  2. To combine the gtin, isbn, upc, ean and amazon_domain parameters, you should refer to the codes provided. Make sure to always specify the relevant Amazon domain from the code lookup. This ensures that you retrieve accurate information about a specific product from the appropriate regional version of Amazon, based on the provided code.
  3. Provide the url parameter containing the link to an Amazon product page. If you use the url parameter, the asin and amazon_domain (or the gtin and amazon_domain) parameters will be disregarded.

Results: Click "200" at the bottom of the page in the Responses block to see the JSON structure of a successful response. For more details click here.

Support

If you have any questions about authentication or API usage, please contact our support team at [email protected].

Query Params
string
enum
Defaults to amazon.com

Used to retrieve search results from. Check the Supported Amazon Domains for a complete list of domains supported. Please note that if you provide the asin and amazon_domain parameters, the url parameter will be ignored.

string
Defaults to B08WGFKSMW

Used for fetching product details. Remember to provide both the asin and amazon_domain parameters. Please note that if you provide the asin and amazon_domain parameters, the url parameter will be ignored.

boolean

Sometimes, Amazon may provide offers from ASINs different from the one specified in the asin request parameter. This can happen when the original ASIN is out of stock. The show_different_asins parameter determines whether you want to see these pricing results from other ASINs or not. You can set show_different_asins to true if you want to include pricing details from other ASINs, or you can keep it as false (default) to hide pricing details from ASINs other than the one provided in the asin parameter. Please note that if you use a url instead of an asin in your request, this parameter will be ignored.

string

GTIN is used for fetching results. ScrapeIN internally converts these codes to an Amazon ASIN and retrieves the corresponding results from Amazon. Remember to use the gtin and amazon_domain parameters together. Please note that if you provide both the gtin and amazon_domain parameters, the url parameter will be ignored. Additionally, if the gtin and asin parameters are both provided, the gtin parameter will be disregarded as the system prioritizes the asin parameter over the gtin parameter to ensure accurate and targeted retrieval of results.

boolean

By default, ScrapeIN caches the GTIN-to-ASIN mapping for 2 months. If you want to perform a fresh GTIN lookup and suspect the existing mapping is outdated, you can use the skip_gtin_cache=true request parameter. Please keep in mind that using skip_gtin_cache=true will deduct 2 requests from your balance instead of 1.

string

Specifies the URL to be scraped instead of using the asin parameter to perform a search query. The url parameter must be URL-encoded. Please note that if you provide the url parameters, the asin and amazon_domain parameters or gtin and amazon_domain parameters will be ignored.

boolean

This parameter allows you to specify whether to include only Prime-eligible offers (true) or include all offers regardless of their Prime-eligibility (false).

boolean

Used to filter the offers returned based on whether they include free shipping. There are two valid values for this parameter: true: Only include offers with free shipping; false: Include all offers, regardless of whether they have free shipping or not.

boolean

The parameter is used to restrict offers to "New" condition only, with two valid values: true (for "New" condition offers) and false (for offers in all conditions), regardless of free shipping availability.

boolean

The parameter is used to restrict offers to "Used-like-new" condition only, with two valid values: true (for "Used-like-new" condition offers) and false (for offers in all conditions).

boolean

This parameter is used to limit offers to only include those in "Used-very-good" condition, with two valid values: true (for including only "Used-very-good" offers) and false (for including offers in all conditions, regardless of their condition).

boolean

This parameter is used to limit offers to "Used-good" condition, with two valid values: true to include only "Used-good" condition offers and false to include offers in all conditions.

boolean

This parameter is used to limit offers to "Used-acceptable" condition only, with two valid values: true (to include only "Used-acceptable" offers) or false (to include offers from all conditions, regardless of their condition).

int32

Used to specify the current page of search results you want to retrieve. To determine the total number of pages available for the search results, you can check the total_results property in the pagination object.

int32

Used to get multiple pages of results in one request, the API will paginate through pages automatically and concatenate the results into one response. See the Pagination for more information.

boolean

Specifies if the response should include raw HTML, which may increase its size. The option to include HTML can be true or false (the default), with the latter being the default.

string
enum
Defaults to json

The format of the returned results can be specified using the output parameter. By default, the results are returned in structured JSON format. You can also choose to receive the raw HTML by setting the parameter to html, or the results in CSV format by setting it to csv.

Allowed:
string
enum

Used to determine the location it uses when fetching pages from Amazon. It helps show how a product appears on amazon.com to customers in different countries. It can also identify cross-border shipping information and opportunities. To find the available values for customer_location, refer to the Locations reference. If no customer_location value is provided, the API will automatically make the request from the country corresponding to the Amazon page requested. For example, if the page is from amazon.de, the default customer_location will be "Germany."

string
enum

Used to determine the language in which the API requests the Amazon page to be displayed. This allows you to choose the preferred language for viewing the page. You can refer to the supported Languages list provided by Amazon to see the supported languages.

string
enum

Used to determine the currency in which the API requests the Amazon page to display prices and monetary values. By specifying the currency, you can view the prices on the page in your preferred currency. You can refer to the supported Currencies list for each Amazon domain to see the currency values that are supported.

string
enum

This parameter allows you to control the API's behavior when it encounters a parsing incident. You can choose to have the API skip serving the request entirely when a degraded or major parsing incident is detected (value: all), or only skip the request when a "major" parsing incident is detected (value: major_only). If your system is making unsupervised requests to the API, using skip_on_incident can be a useful way to handle incidents gracefully.

Allowed:
string

Allows you to specify the JSON field names you want to include in the response JSON object as a comma-separated list. You can use dot notation to specify the field names - for instance, setting include_fields=pagination will only include the pagination property in the JSON response. The include_fields parameter is useful when you only want certain fields to be included in the JSON response returned by the API.

string

Used to exclude certain fields from the JSON object returned by the API. You can specify the names of the fields to be excluded in dot notation as a comma-separated list. For example, exclude_fields=pagination would remove the pagination property from the response JSON. If there are particular fields you don't want to be included in the API's JSON response, use exclude_fields.

string
Responses

Language
Credentials
Query
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json