GET /api/amazon/autocomplete — Search Suggestions

The autocomplete endpoint returns Amazon’s real-time search suggestions for a partial query string. You can use it to power a type-ahead input in your UI, help users discover popular related searches, or pre-populate a search bar as they type. Optionally scope suggestions to a specific category to keep results relevant.

Request

string

required

The partial or full search string to get suggestions for (e.g., "wireless ear").

string

default:"US"

The Amazon marketplace to query. Supported values: US, UK, CA, DE, FR, IT, ES, AU, IN, MX, BR, JP, PL. Defaults to US.

string

Restrict autocomplete suggestions to a specific Amazon category. Pass a category name or ID to focus results (e.g., "electronics").

Example request

curl "https://api.glade.dev/api/amazon/autocomplete?searchTerm=wireless%20ear&domain=US" \
  -H "API-KEY: YOUR_API_KEY"

Response

A successful response returns data.amazonSearchAutocompleteResults — a flat array of suggestion objects, ordered by Amazon’s relevance ranking.

array

Ordered list of autocomplete suggestion objects.

Show amazonSearchAutocompleteResults[]

string

A suggested search term derived from the partial query (e.g., "wireless earbuds"). Always at least one character long.

Example response

{
  "data": {
    "amazonSearchAutocompleteResults": [
      { "suggestion": "wireless earbuds" },
      { "suggestion": "wireless earbuds noise cancelling" },
      { "suggestion": "wireless earbud case" },
      { "suggestion": "wireless ear muffs" },
      { "suggestion": "wireless earbuds for kids" },
      { "suggestion": "wireless earbuds waterproof" }
    ]
  }
}

Error handling

The searchTerm query parameter is required. Sending a request without it returns a 400 error. Requests with an invalid or missing API key return 401.

{
  "success": false,
  "errors": [
    {
      "code": "BAD_REQUEST",
      "message": "Query parameter 'searchTerm' is required.",
      "path": "searchTerm"
    }
  ]
}

Status	Meaning
`400`	Missing or invalid query parameters
`401`	Missing or invalid `API-KEY` / Bearer token
`402`	Plan limit reached or payment required
`429`	Rate limit exceeded
`502`	Upstream Amazon error or bad gateway

Products

Search & Discovery

Sellers & Categories

GET /api/amazon/autocomplete — Search Suggestions

Request

Example request

Response

Example response

Error handling

​Request

​Example request

​Response

​Example response

​Error handling

Request

Example request

Response

Example response

Error handling