JSON POST request example
POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/amazon/autocomplete with Content-Type: application/json and your Authorization: Bearer header.
{
"k": "coffee"
}// request reference
Amazon Autocomplete parameters
Send query parameters with GET /api/amazon/autocomplete. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Search prefix
Enter the beginning of a search query.
kPartial search text to complete.
Type string · GET query or POST JSON
- Minimum characters: 1
Storefront and department
Choose where to search and which department to use.
amazon_domainAmazon storefront hostname.
Type string · GET query or POST JSON · Default amazon.com
amazon_departmentDepartment alias used to narrow suggestions; aps searches all departments.
Type string · GET query or POST JSON · Default aps
- Minimum characters: 1
- Pattern: ^[a-zA-Z0-9_-]+$
// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include search_metadata, search_parameters, suggestions, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.
Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.
Illustrative success response. Result groups and optional fields depend on upstream content.
{
"search_metadata": {
"status": "Success"
},
"search_parameters": {
"k": "coffee"
},
"suggestions": [
{
"value": "coffee beans",
"type": "KEYWORD"
}
],
"submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}