Skip to main content
GET
/
v1
/
amazon
/
autocomplete
Keyword Suggestions
curl --request GET \
  --url https://scrapebadger.com/v1/amazon/autocomplete \
  --header 'x-api-key: <api-key>'
{
  "query": "wireless ear",
  "domain": "com",
  "suggestions": [
    {
      "value": "wireless earbuds",
      "alias": "aps"
    },
    {
      "value": "wireless earbuds bluetooth",
      "alias": "aps"
    },
    {
      "value": "wireless earphones",
      "alias": "electronics"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

query
string
required
Partial search term to expand into suggestions.Example: wireless ear
domain
string
default:"com"
Amazon marketplace TLD or code. Suggestions are localized per marketplace.Examples: com, co.uk, de

Response

query
string
The partial term that was expanded.
domain
string
Marketplace the suggestions came from.
suggestions
array
Array of suggested search phrases.

Example Response

{
  "query": "wireless ear",
  "domain": "com",
  "suggestions": [
    { "value": "wireless earbuds", "alias": "aps" },
    { "value": "wireless earbuds bluetooth", "alias": "aps" },
    { "value": "wireless earphones", "alias": "electronics" }
  ]
}
Each autocomplete request costs 1 credit. Failed requests are not charged.

Authorizations

x-api-key
string
header
required

Query Parameters

query
string
required

Partial search term to expand into suggestions.

domain
string
default:com

Amazon marketplace TLD or code (com, co.uk, de, ...).

Response

200 - application/json

Autocomplete suggestions

query
string
domain
string
suggestions
object[]