Amazon Commerce Search Suggestions API
Get Amazon's search suggestions for the start of a query, the way the search box completes it.
- 0.25 credits per call
- Failed calls are free
- Updated
- amazon.search.suggestions
{ "suggestions": [ { "type": "KeywordSuggestion", "value": "wireless mouse" }, { "type": "KeywordSuggestion", "value": "wireless keyboard and mouse" } ]}
| # | Suggestion | Type |
|---|---|---|
| 1 | wireless mouse | KeywordSuggestion |
| 2 | wireless keyboard and mouse | KeywordSuggestion |
| 3 | wireless earbuds | KeywordSuggestion |
| 4 | wireless keyboard | KeywordSuggestion |
| 5 | wireless carplay adapter | KeywordSuggestion |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| prefix | string | yes | wireless | |
| limit | integer | no | Maximum number of results to return. From 1 to 20. | 5 |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| suggestions[].value | string | The suggested search. | wireless mouse |
| suggestions[].type | string | The kind of suggestion. | KeywordSuggestion |
| suggestions | array | Search suggestions for what you typed. | 5 records |
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "amazon.search.suggestions", "input": { "limit": 5, "prefix": "wireless" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "amazon.search.suggestions", "input": { "limit": 5, "prefix": "wireless" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "amazon.search.suggestions", "input": { "limit": 5, "prefix": "wireless" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
Use Upscrape to get Amazon's search suggestions for wireless and list them in order.
More from the Amazon Commerce API
- Amazon Commerce Listings Search API0.5 credits
- Amazon Commerce Product API1 credit
- Amazon Commerce Product Offers API1 credit
- Amazon Commerce Best Sellers API0.25 credits
- Amazon Commerce Deals API0.5 credits
- Amazon Commerce Seller API0.25 credits
- Amazon Commerce Seller Feedback API0.25 credits
- Amazon Commerce Seller Products API0.25 credits
- Amazon Commerce Featured Product Reviews API1 credit
- Amazon Commerce Category Tree API0.5 credits
The same data from other platforms
Amazon Commerce Search Suggestions API FAQ
The short answers. The docs have the long ones.
How much does the Amazon Commerce Search Suggestions API cost?
0.25 credits per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send prefix. The input fields below list every option with its type and limits.
Do I need an Amazon Commerce login?
No. It reads public Amazon Commerce data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds amazon.search.suggestions, checks its price and runs it with the same credits as the REST API.
Your first Amazon Commerce call is free.
Up to 100 free credits to start, no card needed.