Shopping

Amazon Products

Amazon product details by ASIN or search term — names, prices, descriptions and images.

amazon-productsamazonshoppingmarketplaceproducts

2 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/amazon-products/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 2 rows, this download costs 1 credit when the data is fresh enough, or 2 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/amazon-products/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "asins": [        "B09DH98BHQ"      ],      "searchTerms": [        "bikes",        "kids helmet"      ],      "searchPages": 1,      "domain": "www.amazon.com"    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

asins
string[]
ASINs
Product codes, or whole /dp/ URLs. Used only when no search terms are set, unless both are given.
Default
["B09DH98BHQ"]
Example
B09DH98BHQ
searchTerms
string[]
Search terms
Each term’s result pages are mined for ASINs, which are then fetched as products.
Default
none
Example
bikes, kids helmet
searchPages
number
Search result pages per term
Roughly 60 results per page.
Default
1
Range
1 to 20
domain
enum
Storefront
Amazon localises prices by the requesting IP as well as by domain, so the currency on a row is read off the page rather than assumed from this.
Default
www.amazon.com
Allowed values
www.amazon.com
www.amazon.co.uk
www.amazon.de
www.amazon.fr
www.amazon.it
www.amazon.es
www.amazon.ca

Advanced

maxProducts
number
Max products per run
Across ASINs and search results together.
Default
50
Range
1 to 2000
requestDelayMs
number
Delay between requests (ms)
Amazon throttles aggressively. Lowering this is the fastest way to get a run served captcha pages.
Default
2500
Range
0 to 60000

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "asins": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "ASINs",      "description": "Product codes, or whole /dp/ URLs. Used only when no search terms are set, unless both are given.",      "default": [        "B09DH98BHQ"      ],      "examples": [        "B09DH98BHQ"      ]    },    "searchTerms": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Search terms",      "description": "Each term’s result pages are mined for ASINs, which are then fetched as products.",      "default": [],      "examples": [        "bikes, kids helmet"      ]    },    "searchPages": {      "type": "number",      "minimum": 1,      "maximum": 20,      "title": "Search result pages per term",      "description": "Roughly 60 results per page.",      "default": 1    },    "domain": {      "type": "string",      "enum": [        "www.amazon.com",        "www.amazon.co.uk",        "www.amazon.de",        "www.amazon.fr",        "www.amazon.it",        "www.amazon.es",        "www.amazon.ca"      ],      "title": "Storefront",      "description": "Amazon localises prices by the requesting IP as well as by domain, so the currency on a row is read off the page rather than assumed from this.",      "default": "www.amazon.com"    },    "maxProducts": {      "type": "number",      "minimum": 1,      "maximum": 2000,      "title": "Max products per run",      "description": "Across ASINs and search results together.",      "default": 50    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between requests (ms)",      "description": "Amazon throttles aggressively. Lowering this is the fastest way to get a run served captcha pages.",      "default": 2500    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/amazon-products/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "asins": [        "B09DH98BHQ"      ],      "searchTerms": [        "bikes",        "kids helmet"      ],      "searchPages": 1,      "domain": "www.amazon.com"    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

Field	Type	Coverage
category	string	100%
colors	array	100%
createdAt	date	100%
currency	string	100%
description	string	100%
images	array	100%
marketplace	string	100%
materials	array	100%
name	string	100%
subCategory	string	100%
subSubCategory	string	100%
updatedAt	date	100%
created_at	date	100%
updated_at	date	100%
_id	string	100%