# Amazon Product Search API. Products matching your search. Products by keyword with price, rating and sales. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Damazon.search_products) ## Amazon Product Search API at a glance Returns Amazon's search results for a keyword, on any Amazon marketplace, page by page. Each product has its ASIN, title, price with the list price it is discounted from, image, star rating with the exact number of ratings, and the monthly sales badge. Results that show a brand line also carry the brand, and sponsored results are flagged. Sort by relevance, price, newest or best sellers. GET `/v1/amazon/search_products` [Read the API reference](https://socialtap.dev/docs/reference/amazon/search_products/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **23 typed fields** null when unknown - **60** products per page, Amazon's Featured order, sponsored results among them - **`query`** is all it needs, e.g. `wireless earbuds` ## Send one request. Get up to 60 products back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `query = wireless earbuds` [Open in playground](https://socialtap.dev/playground/?endpoint=amazon.search_products) cURL: ```shell curl -G 'https://socialtap.dev/v1/amazon/search_products' \ --data-urlencode 'query=wireless earbuds' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.amazon.searchProducts.list({ query: "wireless earbuds" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ query: "wireless earbuds", }); const res = await fetch(`https://socialtap.dev/v1/amazon/search_products?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/amazon/search_products", params={"query": "wireless earbuds"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, page, meta = body["data"], body["page"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("query", "wireless earbuds") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/amazon/search_products?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Page json.RawMessage `json:"page"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": [ { "approximate_fields": [ "platform_specific.amazon.rating", "platform_specific.amazon.metrics.bought_past_month_count" ], "attributes": [], "availability": null, "category": null, "category_id": null, "condition": null, "condition_label": null, "country_code": "US", "currency": "USD", "description": null, "id": "B0H8NFRF3S", "max_price": null, "media": [], "original_price": 199.99, "platform": "amazon", "platform_specific": { "amazon": { "availability_label": null, "best_sellers_ranks": [], "brand": null, "categories": [], "contributors": [], "deal": null, "features": [], "is_sponsored": false, "metrics": { "bought_past_month_count": 1000, "offer_count": null, "rating_count": 673, "rating_distribution": null }, "parent_asin": null, "rank": null, "rating": 4.9, "ships_from": null, "variants": [] } }, "price": 19.97, "seller": null, "shipping": { "fee": null, "is_offered": null }, "thumbnail_url": "https://m.media-amazon.com/images/I/61rw2e+AtUL._AC_UY654_FMwebp_QL65_.jpg", "title": "Wireless Earbuds, 2026 Bluetooth 5.4 Headphones Bass Stereo Ear Buds with Noise Cancelling Mic, LED Display in Ear Earphones 50H Playtime Ear Buds, IP7 Waterproof for Laptop Pad Phones Soft White", "type": "product", "unknown_fields": [ "media", "attributes", "platform_specific.amazon.contributors" ], "url": "https://www.amazon.com/dp/B0H8NFRF3S" }, { "approximate_fields": [ "platform_specific.amazon.rating", "platform_specific.amazon.metrics.bought_past_month_count" ], "attributes": [], "availability": null, "category": null, "category_id": null, "condition": null, "condition_label": null, "country_code": "US", "currency": "USD", "description": null, "id": "B0FQFB8FMG", "max_price": null, "media": [], "original_price": 249, "platform": "amazon", "platform_specific": { "amazon": { "availability_label": null, "best_sellers_ranks": [], "brand": null, "categories": [], "contributors": [], "deal": null, "features": [], "is_sponsored": false, "metrics": { "bought_past_month_count": 10000, "offer_count": null, "rating_count": 17730, "rating_distribution": null }, "parent_asin": null, "rank": null, "rating": 4.4, "ships_from": null, "variants": [] } }, "price": 199, "seller": null, "shipping": { "fee": null, "is_offered": null }, "thumbnail_url": "https://m.media-amazon.com/images/I/61solmQSSlL._AC_UY654_FMwebp_QL65_.jpg", "title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation", "type": "product", "unknown_fields": [ "media", "attributes", "platform_specific.amazon.contributors" ], "url": "https://www.amazon.com/dp/B0FQFB8FMG" }, { "approximate_fields": [ "platform_specific.amazon.rating" ], "attributes": [], "availability": null, "category": null, "category_id": null, "condition": null, "condition_label": null, "country_code": "US", "currency": "USD", "description": null, "id": "B0HKS3S2XJ", "max_price": null, "media": [], "original_price": 249.99, "platform": "amazon", "platform_specific": { "amazon": { "availability_label": null, "best_sellers_ranks": [], "brand": null, "categories": [], "contributors": [], "deal": null, "features": [], "is_sponsored": false, "metrics": { "bought_past_month_count": null, "offer_count": null, "rating_count": 363, "rating_distribution": null }, "parent_asin": null, "rank": null, "rating": 4.7, "ships_from": null, "variants": [] } }, "price": 19.99, "seller": null, "shipping": { "fee": null, "is_offered": null }, "thumbnail_url": "https://m.media-amazon.com/images/I/61D5ZCSIymL._AC_UY654_FMwebp_QL65_.jpg", "title": "Wireless Earbuds, Bluetooth 6.0 Headphones HiFi Stereo 50H Playback LED Digital Display Ear Buds with ENC Noise Canceling Headset, IPX7 Waterproof Earphones for Gym/Running/Work(Black)", "type": "product", "unknown_fields": [ "media", "attributes", "platform_specific.amazon.contributors" ], "url": "https://www.amazon.com/dp/B0HKS3S2XJ" } ], "page": { "has_more": true, "next_cursor": "c1.EXAMPLE_CURSOR", "next_cursor_expires_at": "2026-10-26T12:00:00Z", "end_reason": null }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "amazon", "source": "page", "is_cached": false, "credits_charged": 1, "latency_ms": 0, "fetched_at": "2026-10-25T12:00:00Z", "input": null, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 3 platforms. The [response reference](https://socialtap.dev/docs/reference/amazon/search_products/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/product/index.md). - ### Null means unknown A field Amazon doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts What to search for, as typed into Amazon's search box: keywords, a brand, a model or an ISBN. An Amazon search results link searches its keywords on its marketplace. - ### Write one parser Amazon, TikTok Shop and Facebook Marketplace answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktokshop, facebook, …). - **`id`string**: Platform-native product or listing ID (string). - **`url`string**: Canonical product page URL. - **`type`string**: product: a catalog product a shop sells in many units, often in variants (TikTok Shop, Instagram and YouTube shopping); listing: a single item a person or business lists for sale (Facebook Marketplace). New values may be added; treat unknown values as product. - **`title`string**: Product name or listing title, as the seller wrote it. - **`description`string**: Description as plain text (paragraphs separated by blank lines); null when it has none or the source does not show it (lists and search results). - **`category`string**: The platform's most specific category label (Bicycles, Vitamins & Supplements), as shown; not normalized across platforms. - **`category_id`string**: The platform's ID of that category (what its category browsing and filters take). Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Amazon Product Search API. - ### Track where products rank for a keyword - ### Find competitors and their prices - ### Spot which brands buy sponsored placements - ### Build product lists for price tracking - ### Compare a keyword across marketplaces ## Good to know before you build. - Results are in Amazon's order, sponsored ones included: platform_specific.amazon.is_sponsored flags them. A product Amazon shows both as an ad and as an organic result is listed once, as the organic result in its organic position. - A result has what the results page shows. Seller, stock, specifications, variations and the Best Sellers Rank come from the Amazon Product API, sent the result's ASIN. - A price Amazon shows as zero for members (Kindle Unlimited, an Audible trial) is not returned as the price: the price to buy when the result shows one, else null. A result with no featured offer is priced at the lowest of its other offers when it shows one. - Amazon serves a limited number of pages per search, whatever count of matches it reports: the walk ends with page.end_reason platform_limit. - Results, prices and currency are the marketplace's own. Titles are in English where the marketplace offers it. ## 1 credit per page. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/amazon/search_products/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Public page `page` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Amazon Product Search API. More in the [API reference](https://socialtap.dev/docs/reference/amazon/search_products/index.md). **Does it include sponsored products?** Yes, in the position Amazon shows them, each flagged with is_sponsored true. **Which marketplaces can I search?** Every Amazon marketplace: set country to its country code, such as GB for amazon.co.uk or JP for amazon.co.jp. **How much does the Amazon Product Search API cost?** A page of up to 60 products costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours. Other platforms ## Products on 2 more platforms. - [TikTok Shop Search API](https://socialtap.dev/apis/tiktokshop/search_products/index.md) (1 credit / page · `GET /v1/tiktokshop/search_products`) - [Facebook Marketplace Listing API](https://socialtap.dev/apis/facebook/listing/index.md) (1 credit · `GET /v1/facebook/listing`) More Amazon ## Amazon API. 10 endpoints, one key. - [Amazon Shop Posts API](https://socialtap.dev/apis/amazon/shop_posts/index.md) (1 credit / page · `GET /v1/amazon/shop_posts`) - [Amazon Shop API](https://socialtap.dev/apis/amazon/shop/index.md) (1 credit · `GET /v1/amazon/shop`) - [Amazon Seller API](https://socialtap.dev/apis/amazon/seller/index.md) (1 credit · `GET /v1/amazon/seller`) - [Amazon Shop Lists API](https://socialtap.dev/apis/amazon/shop_lists/index.md) (1 credit / page · `GET /v1/amazon/shop_lists`) - [Amazon Product API](https://socialtap.dev/apis/amazon/product/index.md) (1 credit · `GET /v1/amazon/product`) - [Amazon Deals API](https://socialtap.dev/apis/amazon/deal_products/index.md) (1 credit / page · `GET /v1/amazon/deal_products`) - [Amazon Best Sellers API](https://socialtap.dev/apis/amazon/top_products/index.md) (1 credit / page · `GET /v1/amazon/top_products`) - [Amazon Reviews API](https://socialtap.dev/apis/amazon/reviews/index.md) (1 credit / page · `GET /v1/amazon/reviews`) - [Amazon Offers API](https://socialtap.dev/apis/amazon/offers/index.md) (1 credit / page · `GET /v1/amazon/offers`) ## Try it with your own search. Type it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/amazon/search_products/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)