Our Amazon Autocomplete API allows you to get keyword suggestions from Amazon's search autocomplete.


The API endpoint is https://serpapi.com/search?engine=amazon_autocomplete

Head to the playground for a live and interactive demo.

API Parameters

Search Query

k

Required

Parameter defines the search query. A query that would be used to provide completion options on Amazon.

Localization

amazon_domain

Optional

Parameter defines the Amazon domain to use. It defaults to amazon.com. Head to Amazon domains for a full list of supported Amazon domains.

Advanced Autocomplete Parameters

amazon_department

Optional

Parameter defines the Amazon department to scope suggestions to. Defaults to aps (All Departments). Head to Amazon departments for a full list of supported Amazon departments.

Serpapi Parameters

engine

Required

Set parameter to amazon_autocomplete to use the Amazon Autocomplete API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the Amazon Autocomplete results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

zero_trace

Optional

Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

json_restrictor

Optional

Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.

API Results

JSON Results

JSON output includes structured data for suggestions - list of keyword completions for the provided query. Each suggestion includes a value, type, serpapi_link (to refine the autocomplete query), and serpapi_amazon_link (to perform a full Amazon search).

A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.

HTML Results

HTML output is useful to debug JSON results or support features not yet supported by SerpApi. It gives you the raw HTML results from Amazon Autocomplete.

Example with k: coffee parameter

Example with k: coffee parameter

JSON Example

{
  "search_metadata": {
    "id": "6a62746ba618228a35fd6070",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/NSlNk4TOr8zfMKzUzHQDcQ/6a62746ba618228a35fd6070.json",
    "created_at": "2026-07-23 20:07:07 UTC",
    "processed_at": "2026-07-23 20:07:07 UTC",
    "amazon_autocomplete_url": "https://www.amazon.com/s?k=coffee",
    "raw_html_file": "https://serpapi.com/searches/NSlNk4TOr8zfMKzUzHQDcQ/6a62746ba618228a35fd6070.html",
    "prettify_html_file": "https://serpapi.com/searches/NSlNk4TOr8zfMKzUzHQDcQ/6a62746ba618228a35fd6070.prettify",
    "total_time_taken": 0.75
  },
  "search_parameters": {
    "engine": "amazon_autocomplete",
    "k": "coffee",
    "amazon_domain": "amazon.com"
  },
  "search_information": {
    "query_displayed": "coffee",
    "autocomplete_results_state": "Showing completion results."
  },
  "suggestions": [
    {
      "value": "Coffee table by price",
      "type": "WIDGET",
      "items": [
        {
          "value": "Under $100",
          "amazon_link": "https://www.amazon.com/s?k=coffee+table&amp=&rh=n%3A1063318%2Cp_n_price%3A8570764011&amp=&rnid=8570763011&amp=&nav_sdd=aps&amp=&crid=3FDKW79GBW1XU&amp=&sprefix=coffee&amp=&ref=nb_sb_ss_w_sbl-tr-t1_k0_1_6_0"
        },
        {
          "value": "$100 to $500",
          "amazon_link": "https://www.amazon.com/s?k=coffee+table&amp=&rh=n%3A1063318%2Cp_n_price%3A8570765011&amp=&rnid=8570763011&amp=&nav_sdd=aps&amp=&crid=3FDKW79GBW1XU&amp=&sprefix=coffee&amp=&ref=nb_sb_ss_w_sbl-tr-t1_k0_1_6_1"
        },
        {
          "value": "$500 to $1,000",
          "amazon_link": "https://www.amazon.com/s?k=coffee+table&amp=&rh=n%3A1063318%2Cp_n_price%3A8570766011&amp=&rnid=8570763011&amp=&nav_sdd=aps&amp=&crid=3FDKW79GBW1XU&amp=&sprefix=coffee&amp=&ref=nb_sb_ss_w_sbl-tr-t1_k0_1_6_2"
        },
        {
          "value": "$1,000 to $2,500",
          "amazon_link": "https://www.amazon.com/s?k=coffee+table&amp=&rh=n%3A1063318%2Cp_n_price%3A8570767011&amp=&rnid=8570763011&amp=&nav_sdd=aps&amp=&crid=3FDKW79GBW1XU&amp=&sprefix=coffee&amp=&ref=nb_sb_ss_w_sbl-tr-t1_k0_1_6_3"
        }
      ]
    },
    {
      "value": "coffee table",
      "type": "KEYWORD",
      "thumbnail": "https://m.media-amazon.com/images/I/41Q0IEeqGBL.__AC_SL75__.jpg",
      "serpapi_link": "https://serpapi.com/search.json?amazon_domain=amazon.com&engine=amazon_autocomplete&k=coffee+table",
      "serpapi_amazon_link": "https://serpapi.com/search.json?amazon_domain=amazon.com&device=desktop&engine=amazon&k=coffee+table",
      "amazon_link": "https://www.amazon.com/s?k=coffee%20table"
    },
    {
      "value": "coffee",
      "type": "KEYWORD",
      "thumbnail": "https://m.media-amazon.com/images/I/41T+FnDEVxL.__AC_SL75__.jpg",
      "serpapi_link": "https://serpapi.com/search.json?amazon_domain=amazon.com&engine=amazon_autocomplete&k=coffee",
      "serpapi_amazon_link": "https://serpapi.com/search.json?amazon_domain=amazon.com&device=desktop&engine=amazon&k=coffee",
      "amazon_link": "https://www.amazon.com/s?k=coffee"
    },
    {
      "value": "coffee maker",
      "type": "KEYWORD",
      "thumbnail": "https://m.media-amazon.com/images/I/41yJ9JAUWaL.__AC_SL75__.jpg",
      "serpapi_link": "https://serpapi.com/search.json?amazon_domain=amazon.com&engine=amazon_autocomplete&k=coffee+maker",
      "serpapi_amazon_link": "https://serpapi.com/search.json?amazon_domain=amazon.com&device=desktop&engine=amazon&k=coffee+maker",
      "amazon_link": "https://www.amazon.com/s?k=coffee%20maker"
    },
    ...
  ]
}

Example with k: laptop and amazon_domain: amazon.co.uk

Using amazon_domain param to get suggestions from Amazon UK.

Example with k: laptop and amazon_domain: amazon.co.uk

JSON Example

{
  "search_metadata": {
    "id": "6a627436a618228a3296069b",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/c2upPZ9AOn5WN38eK_nwhQ/6a627436a618228a3296069b.json",
    "created_at": "2026-07-23 20:06:14 UTC",
    "processed_at": "2026-07-23 20:06:14 UTC",
    "amazon_autocomplete_url": "https://www.amazon.co.uk/s?k=laptop",
    "raw_html_file": "https://serpapi.com/searches/c2upPZ9AOn5WN38eK_nwhQ/6a627436a618228a3296069b.html",
    "prettify_html_file": "https://serpapi.com/searches/c2upPZ9AOn5WN38eK_nwhQ/6a627436a618228a3296069b.prettify",
    "total_time_taken": 0.72
  },
  "search_parameters": {
    "engine": "amazon_autocomplete",
    "k": "laptop",
    "amazon_domain": "amazon.co.uk"
  },
  "search_information": {
    "query_displayed": "laptop",
    "autocomplete_results_state": "Showing completion results."
  },
  "suggestions": [
    {
      "value": "laptop",
      "type": "KEYWORD",
      "serpapi_link": "https://serpapi.com/search.json?amazon_domain=amazon.co.uk&engine=amazon_autocomplete&k=laptop",
      "serpapi_amazon_link": "https://serpapi.com/search.json?amazon_domain=amazon.co.uk&device=desktop&engine=amazon&k=laptop",
      "amazon_link": "https://www.amazon.co.uk/s?k=laptop"
    },
    {
      "value": "laptop stand",
      "type": "KEYWORD",
      "serpapi_link": "https://serpapi.com/search.json?amazon_domain=amazon.co.uk&engine=amazon_autocomplete&k=laptop+stand",
      "serpapi_amazon_link": "https://serpapi.com/search.json?amazon_domain=amazon.co.uk&device=desktop&engine=amazon&k=laptop+stand",
      "amazon_link": "https://www.amazon.co.uk/s?k=laptop%20stand"
    },
    {
      "value": "laptop bag",
      "type": "KEYWORD",
      "serpapi_link": "https://serpapi.com/search.json?amazon_domain=amazon.co.uk&engine=amazon_autocomplete&k=laptop+bag",
      "serpapi_amazon_link": "https://serpapi.com/search.json?amazon_domain=amazon.co.uk&device=desktop&engine=amazon&k=laptop+bag",
      "amazon_link": "https://www.amazon.co.uk/s?k=laptop%20bag"
    },
    ...
  ]
}

Example with k: coffee and amazon_department: grocery

Using amazon_department to scope suggestions to the Grocery & Gourmet Food department.

Example with k: coffee and amazon_department: grocery

JSON Example

{
  "search_metadata": {
    "id": "6a627462a618228a35fd606f",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/dWWvr10CpeF-29yhKwKnbA/6a627462a618228a35fd606f.json",
    "created_at": "2026-07-23 20:06:58 UTC",
    "processed_at": "2026-07-23 20:06:58 UTC",
    "amazon_autocomplete_url": "https://www.amazon.com/s?k=coffee",
    "raw_html_file": "https://serpapi.com/searches/dWWvr10CpeF-29yhKwKnbA/6a627462a618228a35fd606f.html",
    "prettify_html_file": "https://serpapi.com/searches/dWWvr10CpeF-29yhKwKnbA/6a627462a618228a35fd606f.prettify",
    "total_time_taken": 0.84
  },
  "search_parameters": {
    "engine": "amazon_autocomplete",
    "k": "coffee",
    "amazon_domain": "amazon.com",
    "amazon_department": "grocery"
  },
  "search_information": {
    "query_displayed": "coffee",
    "autocomplete_results_state": "Showing completion results."
  },
  "suggestions": [
    {
      "value": "coffee",
      "type": "KEYWORD",
      "thumbnail": "https://m.media-amazon.com/images/I/41T+FnDEVxL.__AC_SL75__.jpg",
      "serpapi_link": "https://serpapi.com/search.json?amazon_department=grocery&amazon_domain=amazon.com&engine=amazon_autocomplete&k=coffee",
      "amazon_link": "https://www.amazon.com/s?k=coffee&i=grocery"
    },
    {
      "value": "coffee pods",
      "type": "KEYWORD",
      "thumbnail": "https://m.media-amazon.com/images/I/5111AoiaRoL.__AC_SL75__.jpg",
      "serpapi_link": "https://serpapi.com/search.json?amazon_department=grocery&amazon_domain=amazon.com&engine=amazon_autocomplete&k=coffee+pods",
      "amazon_link": "https://www.amazon.com/s?k=coffee%20pods&i=grocery"
    },
    {
      "value": "coffee beans",
      "type": "KEYWORD",
      "thumbnail": "https://m.media-amazon.com/images/I/41X-BhCuoQL.__AC_SL75__.jpg",
      "serpapi_link": "https://serpapi.com/search.json?amazon_department=grocery&amazon_domain=amazon.com&engine=amazon_autocomplete&k=coffee+beans",
      "amazon_link": "https://www.amazon.com/s?k=coffee%20beans&i=grocery"
    },
    ...
  ]
}

JSON structure overview

{
  "search_information": {
    "query_displayed": "String - The search query displayed",
    "autocomplete_results_state": "String - State of the results (e.g. Showing completion results., No results.)"
  },
  "suggestions": [
    {
      "value": "String - Title of this suggestion",
      "subtitle": "String - Subtitle of this suggestion",
      "type": "String - Type of suggestion (e.g. KEYWORD, WIDGET)",
      "thumbnail": "String - Thumbnail for this suggestion",
      "serpapi_link": "String - SerpApi link to refine the autocomplete query with this suggestion",
      "serpapi_amazon_link": "String - SerpApi link to perform a full Amazon search for this suggestion",
      "amazon_link": "String - Link to the Amazon search or store for this suggestion",
      "items": [
        {
          "value": "String - Title of this item",
          "thumbnail": "String - Thumbnail for this item",
          "serpapi_link": "String - SerpApi link to refine the autocomplete query with this item",
          "serpapi_amazon_link": "String - SerpApi link to perform a full Amazon search for this item",
          "amazon_link": "String - Link to the Amazon search for this item"
        },
        ...
      ]
    },
    ...
  ]
}