Amazon Search API (Async)

This endpoint will retrieve products for a specified search term from Amazon search page and transform it into usable JSON.

Single Query request:

import requests

url = "https://async.scraperapi.com/structured/amazon/search"
headers = {
    "Content-Type": "application/json"
}
data = {
    "apiKey": APIKEY,
    "query": QUERY,
    "country_code": COUNTRY_CODE,
    "ref": REFERENCE,
    "s": SORTING,
    "tld": TLD,
    "callback": {
        "type": "webhook",
        "url": "YYYY"
    }
}

response = requests.post(url, json=data, headers=headers)
print(response.text)

Multiple Query request:

import requests

url = "https://async.scraperapi.com/structured/amazon/search"
headers = {
    "Content-Type": "application/json"
}
data = {
    "apiKey": APIKEY,
    "queries": [QUERY1, QUERY2],
    "country_code": COUNTRY_CODE,
    "ref": REFERENCE,
    "s": SORTING,
    "tld": TLD,
    "callback": {
        "type": "webhook",
        "url": "YYYY"
    }
}

response = requests.post(url, json=data, headers=headers)
print(response.text)

Parameters available for this method:

REQUIRED

ApiKey

User account’s normal API key.

QUERY

Search term.

OPTIONAL

TLD

Valid values include:

com (amazon.com)

co.uk (amazon.co.uk)

ca (amazon.ca)

de (amazon.de)

es (amazon.es)

fr (amazon.fr)

it (amazon.it)

jp (amazon.co.jp)

in (amazon.in)

cn (amazon.cn)

sg (amazon.com.sg)

mx (amazon.com.mx)

ae (amazon.ae)

br (amazon.com.br)

nl (amazon.nl)

au (amazon.com.au)

tr (amazon.com.tr)

sa (amazon.sa)

se (amazon.se)

pl (amazon.pl)

COUNTRY

Valid values are two letter country codes for which we offer Geo Targeting (e.g. “au”, “es”, “it”, etc.).

Where an amazon domain needs to be scraped from another country (e.g. scraping amazon.com from Canada to get Canadian shipping information), both TLD and COUNTRY parameters must be specified.

REFERENCE

A reference string used by amazon. For example: olp_f_usedAcceptable

SORTING

Change sorting.

For example: price-desc-rank

Sample Response

Single Query Request:

{
	"id": "f9c41146-ecd3-415c-ae0a-461de670e2e8",
	"status": "running",
	"statusUrl": "http://async.scraperapi.com/structured/amazon/search/f9c41146-ecd3-415c-ae0a-461de670e2e8",
	"query": "ball"
}

Multiple Query Request:

[
[
	{
		"id": "5b0c838a-d0eb-46c3-ad9a-e82e398d56a5",
		"status": "running",
		"statusUrl": "http://async.scraperapi.com/structured/amazon/search/5b0c838a-d0eb-46c3-ad9a-e82e398d56a5",
		"query": "ball"
	},
	{
		"id": "df83b9e1-be25-40de-8702-4e934f057867",
		"status": "running",
		"statusUrl": "http://async.scraperapi.com/structured/amazon/search/df83b9e1-be25-40de-8702-4e934f057867",
		"query": "motorbike"
	}
]

After the job(s) finish, you will find the result under the response key in the response JSON object. The structure is the same as in the corresponding SYNC data endpoint.

Last updated