Amazon Autocomplete

Return Amazon marketplace search suggestions for a partial term. Supports marketplace domain, language, cursor prefix/suffix inputs, marketplace ID override, and result limits.

Execution model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

Parameters

Name	Type	Requirement	Description
prefix / query / q	string	Required	Partial search term. Required unless suffix is supplied.
last_prefix / lastPrefix	string	Optional	Previously typed search prefix.
suffix	string	Optional	Optional text after the cursor.
domain	string	Optional	Amazon TLD or domain, e.g. in, com, co.uk, de, amazon.in.
language	string	Optional	Suggestion language code.
mid	string	Optional	Amazon marketplace ID override.
limit	number	Optional	Maximum suggestions to return (1-20).
timeout_ms	number	Optional	Provider timeout in milliseconds (3000-30000).

Response fields

Field	Type	Description
success	boolean	Whether autocomplete completed successfully.
suggestions	array	Suggestion rows with position, keyword, and suggestion type.
domain	string	Normalized Amazon marketplace domain key.
time_taken	number	API response time in seconds.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/amazon/autocomplete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prefix": "running sh",
  "domain": "in",
  "language": "en",
  "limit": 10
}'

Example response

{
  "success": true,
  "source": "amazon",
  "operation": "autocomplete",
  "prefix": "running sh",
  "domain": "in",
  "count": 3,
  "time_taken": 0.42,
  "suggestions": [
    {
      "position": 1,
      "keyword": "running shoes",
      "type": "KEYWORD"
    },
    {
      "position": 2,
      "keyword": "running shoes for men",
      "type": "KEYWORD"
    },
    {
      "position": 3,
      "keyword": "running shorts",
      "type": "KEYWORD"
    }
  ]
}