Amazon API endpoint

Search Amazon products

Returns normalized Amazon search result cards for `amazon.com`.

GETapiKey3 credits/requestamazon.searchResponseDoc/amazon/search

Parameters

NameInTypeRequiredEnumExampleDescription
kquerystringYesapple watchSearch keyword
squerystringNoreview-rankSort order
pagequeryintegerNo11-based page number
x-api-keyheaderstringYesAPI key required

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost
3 credits/request
Charged response
Successful 2xx responses
PlanPriceIncluded creditsDaily capRate limitOverage
Free$0/mo2,000500 daily credits5/minNo overage
Starter$9/mo20,0005,000 daily credits15/min$0.75/1,000 overage credits when enabled
Growth$29/mo100,00025,000 daily credits45/min$0.45/1,000 overage credits when enabled
Pro$79/mo400,000No daily cap120/min$0.30/1,000 overage credits
Business$199/mo1,200,000No daily cap300/min$0.20/1,000 overage credits
Enterprise$499/mo5,000,000No daily cap1,000/min$0.12/1,000 overage credits

Failure responses

StatusDescriptionSchema
400Bad Request#/definitions/app.Response
404Not Found#/definitions/app.Response
429Too Many Requests#/definitions/app.Response
500Internal Server Error#/definitions/app.Response
502Bad Gateway#/definitions/app.Response

Example response

{
  "code": 200,
  "msg": "OK",
  "data": [
    {
      "asin": "142325113X",
      "title": "ChatGPT Uses & Prompts: a QuickStudy Laminated Reference Guide",
      "is_sponsored": false,
      "link": "https://www.amazon.com/ChatGPT-Uses-Prompts-QuickStudy-Laminated/dp/142325113X/",
      "image": "https://m.media-amazon.com/images/I/71qzQ91Qe0L._AC_UL320_.jpg",
      "rating": 4.4,
      "review_count": 223,
      "price": 8.34,
      "list_price": 8.95,
      "number_of_bought_in_last_month": 0,
      "is_free_delivery": false,
      "more_choice": "https://www.amazon.com/gp/offer-listing/142325113X/"
    }
  ]
}

Request schema

No body schema

Response schema

#/definitions/amazon.searchResponseDoc

FieldTypeRequiredEnumBoundsExampleDescription
codeintegerNo200
dataarrayNo
data[].asinstringNoB0DGJ736JM
data[].imagestringNohttps://m.media-amazon.com/images/I/61eE8SSyPWL._AC_UY545_FMwebp_QL65_.jpg
data[].is_free_deliverybooleanNotrue
data[].is_sponsoredbooleanNotrue
data[].linkstringNohttps://www.amazon.com/Apple-Smartwatch-Midnight-Aluminium-Detection/dp/B0DGJ736JM/
data[].list_pricenumberNo249
data[].more_choicestringNohttps://www.amazon.com/gp/offer-listing/B08KYJPTB6/
data[].number_of_bought_in_last_monthintegerNo1000
data[].pricenumberNo189
data[].ratingnumberNo4.4
data[].review_countintegerNo1055
data[].titlestringNoWatch SE (2nd Gen) [GPS 40mm] Smartwatch with Midnight Aluminium Case with Midnight Sport Band S/M. Fitness and Sleep Trackers, Crash Detection, Heart Rate Monitor, Retina Display
msgstringNoOK

Example request

curl -X GET "https://api.crawlora.net/api/v1/amazon/search?k=apple+watch&s=review-rank&page=1" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/amazon/search");
url.searchParams.set("k", "apple watch");
url.searchParams.set("s", "review-rank");
url.searchParams.set("page", "1");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
  method: "GET",
  headers,
});
const payload = await response.json();