amazon_search
Search Amazon by query and retrieve product listings with prices, ratings, ASINs, and sponsored status. Supports pagination and multiple country domains.
Instructions
Retrieves search result listings from Amazon for any query, including product titles, prices, ratings, review counts, sponsored status, and ASINs, plus pagination links. [Credits: 1 API credit per successful request when country=us (5 credits for other countries per the country parameter). premium=true costs an additional 25 credits per request.] Notes: Pagination is via the page parameter (starts at 1); the response also returns a pagination array of ready-to-use next-page Amazon URLs (informational, not directly usable as this API's own next-page param). Returns: { search_message, location, results: [{type, title, image, has_prime, is_best_seller, is_amazon_choice, limited_time_deal, deal_of_the_day, stars, total_reviews, optimized_url, sponsored, number_of_people_bought, asin, availability_quantity, price_string, price_symbol, price, extracted_price, currency, climate_pledge_friendly, absolute_position, organic_position, certification}], pagination: [urls] }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | The page number of results to retrieve. Starts at 1. | |
| query | Yes | The search query string to look up on Amazon. | |
| domain | Yes | TLD extension of the Amazon domain. Examples: com, in, de, fr, co.uk. See Amazon Supported TLDs doc for the full list. | |
| country | Yes | ISO country code for targeting a specific Amazon marketplace. Costs 5 credits per request except USA which costs 1 credit. See Amazon Supported Countries doc for the full list. (default: us) | |
| premium | No | Set to true to use premium proxies for scraping Amazon, which increases the chances of retrieving sponsored results. Costs 25 credits per request. (default: false) | |
| language | No | Standard ISO 639-1 language code (e.g. en, de, fr) to specify the language for product data. | |
| postal_code | No | To get data from a particular postal code. |