logo

Product Pages (PDP)

View as Markdown

Extract structured product data from Amazon product detail pages

The Product Detail Page (PDP) endpoint extracts comprehensive product information from any Amazon product page. It returns structured JSON data including the product title, pricing, ratings, images, long-form description, best seller rankings, and technical specifications (all parsed and ready to use without any HTML processing on your end).


Endpoint

GET https://api.scrape.do/plugin/amazon/pdp

Input Parameters

ParameterTypeRequiredDescription
tokenstring*Your Scrape.do API authentication token
asinstring*Amazon Standard Identification Number (10-character product ID)
geocodestring*Amazon marketplace country code (e.g., us, gb, de, jp)
zipcodestringPostal code formatted according to country requirements for ZIP-level marketplaces. Use either zipcode or countryName, not both.
countryNamestringCountry-level location for marketplaces without ZIP-level delivery. Passing the marketplace's own country name (for example, countryName=Turkey with geocode=tr) is unnecessary and ignored.
superbooleanEnable residential/mobile proxies for higher success rates. Costs 10x credits (default: false)
languagestringDisplay language as an ISO 639-1 code, or ZH-TW for Traditional Chinese. Amazon.com supports EN, ES, AR, DE, HE, KO, PT, ZH, and ZH-TW.
currencystringISO 4217 display currency (e.g., USD, EUR, ILS, CZK). Amazon converts displayed prices and returns the selected code in currency.
include_htmlbooleanWhen true, the response includes the full raw HTML of the page after the structured JSON output (default: false)

Amazon.com serves languages other than EN and ES only for cross-border delivery. Without a location, the API selects one automatically. A US zipcode combined with one of those languages returns 400 zipcode_language_conflict; use countryName instead when you need a specific cross-border destination.


Response Parameters

FieldTypeDescription
asinstringProduct ASIN number
parent_asinstringParent ASIN for the product variation family. Use it to group sibling size, color, style, or bundle ASINs. For products without variations, it matches asin.
is_sponsoredbooleanWhether the product is a sponsored listing
brandstringBrand name
namestringFull product title
urlstringCanonical product URL
thumbnailstringPrimary product image URL
ratingnumberAverage star rating (0-5)
total_ratingsnumber | nullTotal number of customer ratings as a plain integer across marketplaces. For example, Amazon Poland's 7 489 is returned as 7489. null when the product has no ratings.
pricenumberCurrent selling price
list_pricenumberOriginal list price (if discounted)
currencystringCurrency code (e.g., USD, EUR, GBP)
currency_symbolstringCurrency symbol (e.g., $, €, £)
is_primebooleanWhether Prime shipping is available
shippingobjectStructured shipping details for the current buy-box offer: Prime status (is_prime), the destination ZIP code on ZIP-level requests (location), and delivery options. Each option carries its type, its displayed delivery cost in price, the delivery date when shown, and the original raw_text.
in_stockboolean | nullWhether the product can be purchased right now, from the buy box or, when the buy box is suppressed, from another seller. A listing without a buy box but with live offers still counts as in stock. null means the page shows no stock signal at all (for example, Prime Video titles), so treat it as unknown rather than out of stock.
availability_textstringRaw availability string exactly as Amazon displays it, in the marketplace's language (e.g., In Stock, Only 3 left in stock, Currently unavailable.). Use it when you also need the wording shown on the page. Omitted when the page shows no availability text.
all_badgesarrayPromotional badges shown above the buy box. Badge text is returned exactly as shown on the selected Amazon marketplace.
amazon_choicebooleanWhether the product carries an Amazon's Choice badge
best_sellerbooleanWhether the product carries a #1 Best Seller badge. #1 New Release badges do not set this field.
descriptionstringLong-form product description parsed from the PDP, when Amazon exposes it
ingredientsarrayIngredient names exactly as Amazon shows them, in their listed order. Available for products such as beauty, personal care, fragrance, grocery, and supplements. Omitted when Amazon shows no ingredient list or only a placeholder.
shipping_infoarrayShipping and delivery information strings
more_buying_choicesobjectAlternative seller options with links
imagesarrayEvery product gallery image, in gallery order. Each entry is an object with a url at the largest size Amazon publishes for that image, including images that have no high-resolution version.
best_seller_rankingsarrayCategory rankings with rank numbers. Category names are returned exactly as shown on the page, in its display language. Without language, some marketplaces (for example de, it, es, and jp) are served in English; set language to get local category names.
reviewsarrayReviews shown on the PDP. Each review can include review_id, title, rating, author, date, verified_purchase, vine, and body. Review text and dates are returned as shown on Amazon. vine is true when Amazon marks the review as a Vine Customer Review of Free Product; Vine reviews have verified_purchase: false. Not returned on Amazon.com, where reviews are only shown to signed-in visitors; returned on other marketplaces.
customer_reviewsobjectPercentage of ratings at each star level, keyed from 5 star through 1 star. Values are whole percentages as Amazon displays them and may not total exactly 100. Omitted when Amazon shows no breakdown or the product has no ratings.
technical_detailsobjectKey-value pairs of product specifications
statusstringRequest status (success or error)
errorMessagestringError message if request failed
htmlstringFull raw HTML of the Amazon page (only present when include_html=true)

Example Usage

Step 1: Find the Target Product

Navigate to any Amazon product page. For this example, we'll use an adjustable laptop stand:

Amazon Product Page

Step 2: Get the ASIN

The ASIN (Amazon Standard Identification Number) is the unique 10-character identifier for each product. You can find it in:

  • The product URL: amazon.com/dp/B0C7BKZ883 (the ASIN is B0C7BKZ883)
  • The product details section on the page

Step 3: Send the API Request

curl --location --request GET 'https://api.scrape.do/plugin/amazon/pdp?token=<SDO-token>&asin=B0C7BKZ883&geocode=US'
import requests
import json

token = "<SDO-token>"
asin = "B0C7BKZ883"
geocode = "US"

url = f"https://api.scrape.do/plugin/amazon/pdp?token={token}&asin={asin}&geocode={geocode}"

response = requests.request("GET", url)

print(json.dumps(response.json(), indent=2))
const axios = require('axios');

const token = "<SDO-token>";
const asin = "B0C7BKZ883";
const geocode = "US";

const url = `https://api.scrape.do/plugin/amazon/pdp?token=${token}&asin=${asin}&geocode=${geocode}`;

axios.get(url)
  .then(response => {
    console.log(JSON.stringify(response.data, null, 2));
  })
  .catch(error => {
    console.error(error);
  });
package main

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

func main() {
    token := "<SDO-token>"
    asin := "B0C7BKZ883"
    geocode := "US"

    url := fmt.Sprintf(
        "https://api.scrape.do/plugin/amazon/pdp?token=%s&asin=%s&geocode=%s",
        token, asin, geocode,
    )

    resp, err := http.Get(url)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
require 'net/http'
require 'json'

token = "<SDO-token>"
asin = "B0C7BKZ883"
geocode = "US"

url = URI("https://api.scrape.do/plugin/amazon/pdp?token=#{token}&asin=#{asin}&geocode=#{geocode}")

response = Net::HTTP.get(url)

puts JSON.pretty_generate(JSON.parse(response))
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class AmazonPDP {
    public static void main(String[] args) throws Exception {
        String token = "<SDO-token>";
        String asin = "B0C7BKZ883";
        String geocode = "US";

        String url = String.format(
            "https://api.scrape.do/plugin/amazon/pdp?token=%s&asin=%s&geocode=%s",
            token, asin, geocode
        );

        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");

        BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
        String line;
        StringBuilder response = new StringBuilder();
        while ((line = reader.readLine()) != null) {
            response.append(line);
        }
        reader.close();

        System.out.println(response.toString());
    }
}
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        string token = "<SDO-token>";
        string asin = "B0C7BKZ883";
        string geocode = "US";

        string url = $"https://api.scrape.do/plugin/amazon/pdp?token={token}&asin={asin}&geocode={geocode}";

        using HttpClient client = new HttpClient();
        string response = await client.GetStringAsync(url);

        Console.WriteLine(response);
    }
}
<?php
$token = "<SDO-token>";
$asin = "B0C7BKZ883";
$geocode = "US";

$url = "https://api.scrape.do/plugin/amazon/pdp?token={$token}&asin={$asin}&geocode={$geocode}";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
?>

Step 4: Receive Structured Data

The API returns a complete JSON object with all product information:

{
  "asin": "B0C7BKZ883",
  "parent_asin": "B0HBW3QDGK",
  "is_sponsored": false,
  "brand": "Gogoonike",
  "name": "Adjustable Laptop Stand for Desk, Metal Foldable Laptop Riser Holder...",
  "url": "https://www.amazon.com/dp/B0C7BKZ883",
  "thumbnail": "https://m.media-amazon.com/images/I/71Jz2L1pV6L._AC_SX679_.jpg",
  "rating": 4.6,
  "total_ratings": 2712,
  "customer_reviews": {
    "5 star": 79,
    "4 star": 14,
    "3 star": 4,
    "2 star": 1,
    "1 star": 2
  },
  "price": 14.99,
  "list_price": 39.99,
  "currency": "USD",
  "currency_symbol": "$",
  "is_prime": true,
  "in_stock": true,
  "availability_text": "In Stock",
  "all_badges": ["#1 Best Seller"],
  "amazon_choice": false,
  "best_seller": true,
  "description": "Raise your laptop to a comfortable viewing angle with a foldable aluminum stand designed for desks, travel, and daily work.",
  "shipping_info": [
    "FREE delivery Monday, December 16",
    "Or fastest delivery Friday, December 13"
  ],
  "more_buying_choices": {
    "heading": "More Buying Choices",
    "offer_text": "New from $14.99",
    "offer_link": "https://www.amazon.com/gp/offer-listing/B0C7BKZ883"
  },
  "images": [
    { "url": "https://m.media-amazon.com/images/I/71Jz2L1pV6L._AC_SL1500_.jpg" }
  ],
  "best_seller_rankings": [
    { "category": "Office Products", "rank": 249 },
    { "category": "Laptop Stands", "rank": 2 }
  ],
  "technical_details": {
    "Brand": "Gogoonike",
    "Compatible Devices": "Laptop",
    "Material": "Aluminum",
    "Item Weight": "1.1 Pounds"
  },
  "status": "success",
  "errorMessage": null
}

Cross-Border Delivery Charges

When you localize a request to an international destination with countryName, each shipping.options[] entry reports the delivery amount Amazon displays. Paid delivery is returned as its numeric price, while free delivery and options displayed without an amount return 0.

{
  "shipping": {
    "is_prime": false,
    "options": [
      {
        "type": "standard",
        "price": 20.97,
        "is_prime": false,
        "delivery_date": { "by": "Thursday, November 26", "formatted": "Thursday, November 26" },
        "raw_text": "Delivery Thursday, November 26"
      }
    ]
  }
}

In this example, Amazon.com shows $20.97 AmazonGlobal Shipping to Germany, so the option's price is 20.97.

The images array keeps the product gallery order and uses the largest size Amazon publishes for each image, including gallery images that have no high-resolution version. The response is limited to a maximum of 8MB.

The description field is returned as a single prose string when Amazon exposes a product description. It falls back to enhanced manufacturer content when the standard description block is absent, and it can be omitted for listings that do not publish a description.

Add include_html=true to your request to receive the full raw HTML of the Amazon page alongside the structured JSON output. The HTML will be included in an html field at the end of the response.

On this page