Amazon Product Search API. Products matching your search.

Products by keyword with price, rating and sales. We handle the proxies, blocks and platform changes.

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

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

GET /v1/amazon/search_productsTry in

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);

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"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/amazon/search_products")
uri.query = URI.encode_www_form('query' => 'wireless earbuds')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
    'query' => 'wireless earbuds',
]);
$ch = curl_init('https://socialtap.dev/v1/amazon/search_products?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

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"])
}

curl -G 'https://socialtap.dev/v1/amazon/search_products' \
  --data-urlencode 'query=wireless earbuds' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

{
  "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": []
  }
}

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);

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) throws Exception {
        String query = "query=" + encode("wireless earbuds");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/amazon/search_products?" + query))
            .header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
        if (response.statusCode() >= 400) throw new RuntimeException(response.body());
        System.out.println(response.body());
    }

    static String encode(String value) {
        return URLEncoder.encode(value, StandardCharsets.UTF_8);
    }
}

using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));

var query = string.Join("&",
    "query=" + Uri.EscapeDataString("wireless earbuds"));
var res = await http.GetAsync("https://socialtap.dev/v1/amazon/search_products?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
    var error = body.RootElement.GetProperty("error");
    throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = reqwest::blocking::Client::new()
        .get("https://socialtap.dev/v1/amazon/search_products")
        .query(&[("query", "wireless earbuds")])
        .header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
        .send()?;
    let ok = res.status().is_success();
    let body: serde_json::Value = res.json()?;
    if !ok {
        return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
    }
    println!("{} {}", body["data"], body["meta"]["credits_charged"]);
    Ok(())
}

200 OK · GET https://socialtap.dev/v1/amazon/search_productsLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 3 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

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.

platformstring: Platform ID (tiktokshop, facebook, …).
idstring: Platform-native product or listing ID (string).
urlstring: Canonical product page URL.
typestring: 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.
titlestring: Product name or listing title, as the seller wrote it.
descriptionstring: 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).
categorystring: The platform's most specific category label (Bicycles, Vitamins & Supplements), as shown; not normalized across platforms.
category_idstring: The platform's ID of that category (what its category browsing and filters take).

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 How this endpoint is priced How credits work

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.

Try it with your own search.

Type it in the playground, or copy the request into your code.

free credits

No credit card
Failed requests are free
Works on all 218 endpoints

Start for free Read the docs

Amazon Product Search API. Products matching your search.

Amazon Product Search API at a glance

Send one request. Get up to 60 products back.

One schema on 3 platforms.

Null means unknown

What it accepts

Write one parser

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.

1 credit per page. Failed requests are free.

Questions about the Amazon Product Search API.

Products on 2 more platforms.

Amazon API. 10 endpoints, one key.

Try it with your own search.