Bestsellers

Top-selling products for a category (browse node).

GET /v1/amazon/bestsellers

Bestsellers

cURL

curl --request GET \
  --url https://scrapebadger.com/v1/amazon/bestsellers \
  --header 'x-api-key: <api-key>'

import requests

url = "https://scrapebadger.com/v1/amazon/bestsellers"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://scrapebadger.com/v1/amazon/bestsellers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://scrapebadger.com/v1/amazon/bestsellers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://scrapebadger.com/v1/amazon/bestsellers"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/amazon/bestsellers")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://scrapebadger.com/v1/amazon/bestsellers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

200

{
  "domain": "com",
  "category": "electronics",
  "results": [
    {
      "rank": 1,
      "position": 1,
      "asin": "B09B8V1LZ3",
      "title": "Apple AirTag",
      "link": "https://www.amazon.com/dp/B09B8V1LZ3",
      "image": "https://m.media-amazon.com/images/I/71abc.jpg",
      "rating": 4.7,
      "ratings_total": 412300,
      "price": {
        "value": 24,
        "currency": "USD",
        "symbol": "$",
        "raw": "$24.00"
      }
    }
  ]
}

Query Parameters

domain · string · default: "com"

Amazon marketplace TLD or code.

Examples: com, co.uk, de

category · string

Bestsellers node id or category slug. Use /v1/amazon/categories to look up nodes. Defaults to the marketplace’s electronics grid on .com.

Example: electronics, books

page · integer · default: 1

Page number. Each page covers 50 ranks. Range: 1 - 2.

Response

domain · string

Marketplace domain.

category · string

Category/node the list was pulled from (nullable).

results · array

Array of ranked bestseller products.

Show Bestseller object

rank · integer

Best-seller rank.

position · integer

Position on the page.

asin · string

Product ASIN.

title · string

Product title.

link · string

Full URL to the product page.

image · string

Primary product image URL.

rating · number

Average star rating (nullable).

ratings_total · integer

Total number of ratings (nullable).

price · object

Price object with value, currency, symbol, raw.

Example Response

{
  "domain": "com",
  "category": "electronics",
  "results": [
    {
      "rank": 1,
      "position": 1,
      "asin": "B09B8V1LZ3",
      "title": "Apple AirTag",
      "link": "https://www.amazon.com/dp/B09B8V1LZ3",
      "image": "https://m.media-amazon.com/images/I/71abc.jpg",
      "rating": 4.7,
      "ratings_total": 412300,
      "price": { "value": 24.0, "currency": "USD", "symbol": "$", "raw": "$24.00" }
    }
  ]
}

Each bestsellers request costs 5 credits. Failed requests are not charged.

Authorizations

x-api-key · string · header · required

Query Parameters

domain · string · default: com

Amazon marketplace TLD or code (com, co.uk, de, ...).

category · string

Bestsellers node id or category slug (e.g. electronics).

page · integer · default: 1

Page number (each page covers 50 ranks; max 2).

Required range: 1 <= x <= 2

Response

200 - application/json

Bestsellers list

domain · string

category · string | null

results · object[]

Show child attributes