Search an Amazon store (prices in PLN)
amazon_searchSearch one Amazon store (22 countries; default amazon.pl) via SerpAPI, with every price also in PLN at the official NBP mid rate. Costs one SerpAPI credit per call (a repeat within 5 minutes is cached and free). Refine with sort, page, min_price/max_price (store currency; enforced on the displayed price), brand, category_node, min_rating/min_reviews (applied to the returned page), include_sponsored, and any refinement Amazon offers on that page via rh: the result's filters lists each option's rh (Prime, 4★ & up, New condition, sold by Amazon, deals, features…) — pass them comma-separated. A store printing PLN itself (shipping_location 'PL' on a foreign store) is taken as-is. Use amazon_compare for several stores at once and amazon_product for one ASIN's offers, sellers and specs. Result shape: { source, fetchedAt, query, marketplace: { code, domain, country, currency, language }, search_url, total_results (Amazon's own count, before this page's post-filters), query_displayed?, page, next_page, count, products: [...], filters?: { : [{ name, rh }] }, categories?: [{ name, node }], related_searches?, fx: [{ currency, rate, table, table_no, effective_date, source: 'NBP' }], note? } — the list key is products. Each product: { position, asin, title, brand?, url (https://www./dp/), image?, price (number, in currency), price_text (as displayed), currency (ISO, read from the displayed price), price_pln, old_price?, discount_percent?, rating, reviews, bought_last_month?, prime? (only stores that mark it), sponsored, badges?, delivery?, stock?, coupon?, offers?, more_buying_choices?, variants?: [{ asin, title }], purchase_options? }. price_pln is null when there is no price or no NBP rate (the note says why). A search Amazon answers with nothing is count: 0 plus a note on what to relax — a successful result, not an error.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rh | No | Amazon refinements, comma-separated key:value pairs exactly as a previous result's `filters` list them (e.g. 'p_n_condition-type:776949031,p_72:419117031'). Ids are store-specific. | |
| page | No | Result page, 1–20. Default 1. | |
| sort | No | Amazon's sort: relevance (default, Amazon's 'Featured'), price_asc, price_desc, rating (avg. customer review), newest, bestsellers. The price sorts are re-applied to the returned page by displayed price (Amazon sorts by its offer prices), with products that show no price listed last. | |
| brand | No | One brand name as Amazon spells it, e.g. 'Sony' (Amazon's brand filter). | |
| limit | No | Max products returned (1–60). Default 20. | |
| query | No | What you'd type in Amazon's search box, e.g. 'sony wh-1000xm5'. Required unless category_node is set. | |
| language | No | Store language as <language>_<REGION>, e.g. 'en_GB' for English titles on amazon.de. Default: the store's own (de_DE on amazon.de) — each store only offers a few (amazon_marketplaces lists them). | |
| no_cache | No | Force a fresh SerpAPI fetch, bypassing this server's 5-minute result cache. Default false. | |
| max_price | No | Highest price in the store's currency, applied like min_price. | |
| min_price | No | Lowest price in the STORE's currency (EUR on amazon.de). Sent to Amazon, then enforced on the displayed price: out-of-range products and products without a price are dropped (the note counts them). | |
| min_rating | No | Keep products rated at least this (0–5), filtered on the returned page. | |
| marketplace | No | Amazon store: its code (pl, de, fr, it, es, nl, be, se, uk, tr, us, ca, mx, br, au, jp, in, cn, sg, ae, sa, eg) or domain (amazon.de, amazon.co.uk…). Default pl. | |
| min_reviews | No | Keep products with at least this many ratings, filtered on the returned page. | |
| delivery_zip | No | Delivery postal code within shipping_location's country (or the store's), e.g. '00-001'. | |
| category_node | No | Amazon browse-node id (digits) to search within — from a result's `categories`, or node=… in an Amazon category URL. Ids differ per store. Without a query this browses the category. | |
| convert_to_pln | No | Add price_pln at the NBP mid rate. Default true. | |
| include_filters | No | Return the page's refinement `filters` (name + rh per option). Default true. | |
| include_sponsored | No | Keep sponsored slots (marked sponsored: true). Default false — ads repeat and distort ranking. | |
| shipping_location | No | Deliver-to country as an ISO code, e.g. 'PL': a foreign store then lists only items it delivers there, adds delivery cost to `delivery`, and usually prints prices already converted to PLN by Amazon (VAT of the destination). 'local' (or omitted) = the store's own country. | |
| exclude_autocorrected | No | Drop results Amazon adds from an auto-corrected spelling of the query. Default false. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fx | Yes | ||
| note | No | ||
| page | No | ||
| count | Yes | ||
| query | Yes | ||
| source | Yes | ||
| filters | No | ||
| products | Yes | ||
| fetchedAt | Yes | ||
| next_page | No | ||
| categories | No | ||
| search_url | No | ||
| marketplace | Yes | ||
| total_results | No | ||
| related_searches | No |