Amazon Deals API. Deals, on request.

Today's Deals with deal price, badge and end time. We handle the proxies, blocks and platform changes.

Returns Amazon's Today's Deals on any Amazon marketplace, all deals or one category's, in Amazon's own order. Each product has its deal price and the list or typical price it beats, the deal's type, badge and end time, the share of a lightning deal claimed, and any coupon's price. You also get the title, image, brand and star rating with its exact count.

GET /v1/amazon/deal_products

Read the API reference

1 credit per page, $0.75–$1.97 per 1,000 pages
23 typed fields null when unknown
100 deals per page, Amazon's Today's Deals order (its own ranking, as the grid shows it)
100 credits free when you sign up, no card, so you can build before you spend

Send one request. Get up to 100 deals 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

Open in playground

GET /v1/amazon/deal_productsTry in

const params = new URLSearchParams({
});
const res = await fetch(`https://socialtap.dev/v1/amazon/deal_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/deal_products",
    params={},
    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/deal_products")
uri.query = URI.encode_www_form()
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([
]);
$ch = curl_init('https://socialtap.dev/v1/amazon/deal_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{}
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/amazon/deal_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 'https://socialtap.dev/v1/amazon/deal_products' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

{
  "data": [
    {
      "approximate_fields": [
        "platform_specific.amazon.rating",
        "platform_specific.amazon.metrics.rating_distribution"
      ],
      "attributes": [],
      "availability": "in_stock",
      "category": null,
      "category_id": null,
      "condition": "new",
      "condition_label": null,
      "country_code": "US",
      "currency": "USD",
      "description": null,
      "id": "B0G2D1R15Q",
      "max_price": null,
      "media": [],
      "original_price": 99.99,
      "platform": "amazon",
      "platform_specific": {
        "amazon": {
          "availability_label": null,
          "best_sellers_ranks": [],
          "brand": "Ring",
          "categories": [],
          "contributors": [],
          "deal": {
            "badge": "60% off",
            "claimed_percent": null,
            "coupon_id": null,
            "coupon_price": null,
            "department_ids": [
              "16333372011",
              "172282",
              "493964"
            ],
            "ends_at": null,
            "id": "d0d0a6d6",
            "label": "Early Black Friday Deal",
            "original_price_label": "typical",
            "status": "available",
            "type": "best_deal"
          },
          "features": [],
          "is_sponsored": null,
          "metrics": {
            "bought_past_month_count": null,
            "offer_count": null,
            "rating_count": 8694,
            "rating_distribution": {
              "five_star_count": 6260,
              "four_star_count": 696,
              "one_star_count": 956,
              "three_star_count": 522,
              "two_star_count": 261
            }
          },
          "parent_asin": null,
          "rank": null,
          "rating": 4.2,
          "ships_from": null,
          "variants": []
        }
      },
      "price": 39.99,
      "seller": null,
      "shipping": {
        "fee": null,
        "is_offered": null
      },
      "thumbnail_url": "https://m.media-amazon.com/images/I/51kY6VkfPeL.jpg",
      "title": "Ring Battery Doorbell 2K (newest model), Matte Mocha",
      "type": "product",
      "unknown_fields": [
        "media",
        "attributes",
        "platform_specific.amazon.contributors"
      ],
      "url": "https://www.amazon.com/dp/B0G2D1R15Q"
    },
    {
      "approximate_fields": [
        "platform_specific.amazon.rating",
        "platform_specific.amazon.metrics.rating_distribution"
      ],
      "attributes": [],
      "availability": "in_stock",
      "category": null,
      "category_id": null,
      "condition": "new",
      "condition_label": null,
      "country_code": "US",
      "currency": "USD",
      "description": null,
      "id": "B0CHDM8VVZ",
      "max_price": null,
      "media": [],
      "original_price": 399,
      "platform": "amazon",
      "platform_specific": {
        "amazon": {
          "availability_label": null,
          "best_sellers_ranks": [],
          "brand": "Bambu Lab",
          "categories": [],
          "contributors": [],
          "deal": {
            "badge": "13% off",
            "claimed_percent": null,
            "coupon_id": null,
            "coupon_price": null,
            "department_ids": [
              "16310091",
              "16310161"
            ],
            "ends_at": null,
            "id": "23721016",
            "label": "Limited time deal",
            "original_price_label": "list",
            "status": "available",
            "type": "best_deal"
          },
          "features": [],
          "is_sponsored": null,
          "metrics": {
            "bought_past_month_count": null,
            "offer_count": null,
            "rating_count": 444,
            "rating_distribution": {
              "five_star_count": 355,
              "four_star_count": 22,
              "one_star_count": 36,
              "three_star_count": 27,
              "two_star_count": 4
            }
          },
          "parent_asin": null,
          "rank": null,
          "rating": 4.5,
          "ships_from": null,
          "variants": []
        }
      },
      "price": 349,
      "seller": null,
      "shipping": {
        "fee": null,
        "is_offered": null
      },
      "thumbnail_url": "https://m.media-amazon.com/images/I/61IXKmM4f9L.jpg",
      "title": "Bambu Lab P1S 3D Printer, Ready-to-Use FDM 3D Printer | Beginner-Friendly Ecosystem with MakerWorld Model Library, Enclosed CoreXY, High Speed & Precision Printing",
      "type": "product",
      "unknown_fields": [
        "media",
        "attributes",
        "platform_specific.amazon.contributors"
      ],
      "url": "https://www.amazon.com/dp/B0CHDM8VVZ"
    },
    {
      "approximate_fields": [
        "platform_specific.amazon.rating",
        "platform_specific.amazon.metrics.rating_distribution"
      ],
      "attributes": [],
      "availability": "in_stock",
      "category": null,
      "category_id": null,
      "condition": "new",
      "condition_label": null,
      "country_code": "US",
      "currency": "USD",
      "description": null,
      "id": "B0FQV6LMVX",
      "max_price": null,
      "media": [],
      "original_price": 1199,
      "platform": "amazon",
      "platform_specific": {
        "amazon": {
          "availability_label": null,
          "best_sellers_ranks": [],
          "brand": "EF ECOFLOW",
          "categories": [],
          "contributors": [],
          "deal": {
            "badge": "27% off",
            "claimed_percent": null,
            "coupon_id": null,
            "coupon_price": null,
            "department_ids": [
              "16310091",
              "16310161",
              "2972638011"
            ],
            "ends_at": null,
            "id": "ee891d27",
            "label": "Limited time deal",
            "original_price_label": "list",
            "status": "available",
            "type": "best_deal"
          },
          "features": [],
          "is_sponsored": null,
          "metrics": {
            "bought_past_month_count": null,
            "offer_count": null,
            "rating_count": 661,
            "rating_distribution": {
              "five_star_count": 582,
              "four_star_count": 40,
              "one_star_count": 26,
              "three_star_count": 13,
              "two_star_count": 0
            }
          },
          "parent_asin": null,
          "rank": null,
          "rating": 4.7,
          "ships_from": null,
          "variants": []
        }
      },
      "price": 878.99,
      "seller": null,
      "shipping": {
        "fee": null,
        "is_offered": null
      },
      "thumbnail_url": "https://m.media-amazon.com/images/I/61XcQS5XuML.jpg",
      "title": "EF ECOFLOW DELTA 3 Max Portable Power Station, 2048Wh LFP Battery, 2400W | 3400W X-Boost Output, Ultra-Fast 0-80% Charging in 1.13 Hr, Home Backup & RV Camping, Solar Generator (Solar Panel Optional)",
      "type": "product",
      "unknown_fields": [
        "media",
        "attributes",
        "platform_specific.amazon.contributors"
      ],
      "url": "https://www.amazon.com/dp/B0FQV6LMVX"
    }
  ],
  "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": "api",
    "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.dealProducts.list({});
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 = "";
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/amazon/deal_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("&",);
var res = await http.GetAsync("https://socialtap.dev/v1/amazon/deal_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/deal_products")
        .query(&[])
        .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/deal_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.
No input needed
Every parameter is optional: the plain request returns the default list.
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 Deals API.

Track the day's best Amazon deals
Alert on lightning deals in a category
Compare deals across marketplaces
Feed a deals site or newsletter

Good to know before you build.

Amazon serves only the first part of each deals list. When it stops, page.end_reason is platform_limit: ask for one category at a time to read further.
price is the deal price and original_price what Amazon compares it with: platform_specific.amazon.deal.original_price_label says whether that is the list price, the typical price or another reference.
ends_at is set when the deal shows a countdown, mostly lightning deals. claimed_percent is rounded by Amazon and listed in approximate_fields.
A product listed for its coupon alone has deal.type coupon. coupon_price is what it costs once the coupon is clipped.
Deals change through the day, so a later page can repeat or skip a product that moved in the ranking.

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
Platform API `api`	1 credit	$0.75–$1.97
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 Deals API.

See what's on the list right now.

Run 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 Deals API. Deals, on request.

Amazon Deals API at a glance

Send one request. Get up to 100 deals back.

One schema on 3 platforms.

Null means unknown

No input needed

Write one parser

What teams build with the Amazon Deals API.

Track the day's best Amazon deals

Alert on lightning deals in a category

Compare deals across marketplaces

Feed a deals site or newsletter

Good to know before you build.

1 credit per page. Failed requests are free.

Questions about the Amazon Deals API.

Products on 2 more platforms.

Amazon API. 10 endpoints, one key.

See what's on the list right now.