SerpBase

API reference · E-commerce

Amazon Search Autocomplete

Get Amazon query suggestions from a prefix. This endpoint returns autocomplete suggestions, not product detail or price history.

POSThttps://api.serpbase.dev/amazon/autocomplete
1 creditOpen in Playground

Example

BASH
curl -X POST 'https://api.serpbase.dev/amazon/autocomplete' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  --max-time 60 \
  -d '{"prefix":"laptop"}'
Response · real, shortened
{
  "status": 0,
  "credits_charged": 1,
  "request_id": "r-4b27fe8a36d9ac303a5da7dd",
  "product_id": "amazon_autocomplete",
  "action": "autocomplete",
  "source": "amazon",
  "suggestions": [
    {
      "text": "laptop",
      "type": "KEYWORD"
    },
    {
      "text": "laptop stand",
      "type": "KEYWORD"
    }
  ],
  "url": "https://www.amazon.com/suggestions?alias=aps&limit=11&lop=en_US&plain-mid=1&prefix=laptop&site-varia…"
}

Parameters

format
"json" | "markdown"
json (default) returns the parsed result.
More

markdown returns the same result as Markdown text (text/markdown) for language models: no envelope, no duplicate alias fields, no inline images. Same credits; failures keep the JSON envelope.

prefix
string
Example: "laptop"
amazon_domain
string
Public alias for domain.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

country
string
Public alias for locale.country.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

cursor
string
Public alias for pagination.cursor.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

device
string
Public alias for options.device.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

gl
string
Public alias for locale.country.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

hl
string
Public alias for locale.language.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

html
boolean
Public alias for include_html.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

language
string
Public alias for locale.language.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

limit
integer
Public alias for pagination.limit.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

markdown
boolean
Public alias for include_markdown.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

mid
string
Public alias for marketplace_id.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

mobile
boolean
Public alias for options.device.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

num
integer
Public alias for pagination.limit.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

page
integer
Public alias for pagination.page.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

q
string
Public alias for query.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

type
string
Public alias for search_type.
More

Use one spelling at a time; the API validates the parameters and values supported by this product.

The sample shows example parameters, not the complete request contract. Known fields are validated by the API; additional parameters are allowed.

What comes back

The fields are those in the response above; every endpoint also carries status, credits_charged and request_id.

If it fails

A failed request has a non-zero status and an error, and is not charged. The ones you will see here:

1000A parameter is missing or wrongFix the request
1020No credits leftTop up
1029Over your requests per secondWait Retry-After seconds
1502 · 1504The source could not be read this timeRetry
All status codes →