Get an Amazon product

Try in Playground

Read a public Amazon product by ASIN: title, brand, feature bullets, merchant, price, rating, image gallery and availability.

GET/v1/amazon/productx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

asinstringrequiredquery

10-character ASIN.

ExampleB000000001

countryenumdefault: "US"query

Marketplace as ISO 3166-1 alpha-2: US (default), GB, CA, DE, FR, IT, ES, JP, IN, MX, BR, AU or NL. Prices come in that marketplace's currency and numbers are parsed with its locale.

one of: US, GB, CA, DE, FR, IT, ES, JP, IN, MX, BR, AU, NL · default: "US"

Response fields

requestIdstring

Random operational correlation ID.

Upstream attempts, decoded HTML bytes and elapsed milliseconds.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable public data was retrieved.

statusenum

success, partial, failed or challenged. Inspect coverage even for HTTP 200.

one of: success, partial

sourceUrlstring

Public www.amazon.com URL that was read.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Complete means this bounded page had no known omissions; warnings name each omission.

coverage.sourcestring

Always public_page.

coverage.completeboolean

False when any warning is present.

coverage.warningsstring[]

Machine-readable omission codes such as lazy_loaded_ranks_omitted or record_limit.

Canonical product object.

product.idstring

Amazon ASIN.

product.urlstring

Canonical https://www.amazon.com/dp/{asin} URL.

absolute HTTPS URL

product.titlestringnullable

Product title without the differentiator line.

product.descriptionstringnullable

Feature bullets joined by line breaks; null on list pages.

product.sellerstringnullable

Buy-box merchant name when the product page shows one; null on list pages.

product.brandstringnullable

Brand from the byline ("Visit the X Store" / "Brand: X"); null on list pages.

Current and original (list/typical) price with ISO currency; unknown parts are null.

product.price.currentnumbernullable

Price to pay as a number.

product.price.originalnumbernullable

Struck-through list or typical price when shown.

product.price.currencystringnullable

The marketplace currency (USD for the US marketplace), null without a price.

Aggregate star rating and rating count.

product.rating.averagenumbernullable

Stars out of 5.

product.rating.countintegernullable

Number of ratings.

product.image_urlsstring | string[]nullable

Array of full-size gallery URLs on the product page; a single largest image URL on list pages.

product.availabilitystringnullable

Availability text from the product page, otherwise null.

product.reviews_countintegernullable

Always null; Amazon exposes rating counts, not review counts, on public pages.

Product information rows: group (section heading when shown), name and value.

up to 200 items

product.specifications.groupstringnullable

Always included.

product.specifications.namestringnullable

Always included.

product.specifications.valuestringnullable

Always included.

Twister siblings: ASIN, displayed dimension values as title, canonical URL and the dimension names as category; a product without variations lists itself.

up to 200 items

product.variations.idstring

Always included.

product.variations.titlestringnullable

Always included.

product.variations.urlstring

Always included.

absolute HTTPS URL

product.variations.categorystringnullable

Always included.

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
400	`invalid_request`	Missing, duplicate, unsupported or invalid parameters.
401	`unauthorized`	Missing or invalid service key.
404	`not_found`	Storefront, product, category or seller page not found.
429	`upstream_rate_limited`	Amazon rate limited the request; no automatic retry.
502	`upstream_challenged`	Robot check, sign-in wall or HTTP 503 from Amazon.
502	`unsupported_page` `unsafe_redirect` `response_too_large` `payload_too_complex` `request_limit` `upstream_error`	Bounded retrieval failed or the page did not match the requested entity.
503	`busy`	All worker slots occupied.
504	`timeout`	Deadline exceeded.
200	`partial`	Coverage warnings such as lazy_loaded_ranks_omitted or record_limit.

Code example

curl "https://api.scrapeatlas.com/v1/amazon/product?asin=B000000001" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/amazon/product?asin=B000000001",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/amazon/product?asin=B000000001",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Amazon request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/amazon/product",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "asin": "B000000001"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/amazon/product?asin=B000000001", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/amazon/product?asin=B000000001"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://www.amazon.com/dp/B000000001",
  "fetchedAt": "2026-09-11T00:00:00.000Z",
  "coverage": {
    "source": "public_page",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 140000,
    "durationMs": 620
  },
  "product": {
    "id": "B000000001",
    "url": "https://www.amazon.com/dp/B000000001",
    "title": "Synthetic Lock, Blue",
    "description": "Durable construction.\nEasy installation.",
    "seller": "SYNTHETIC STORE",
    "brand": "Synthetic",
    "price": {
      "current": 12.99,
      "original": 19.99,
      "currency": "USD"
    },
    "rating": {
      "average": 4.2,
      "count": 158
    },
    "image_urls": [
      "https://m.media-amazon.com/images/I/synthetic1._AC_SL1500_.jpg",
      "https://m.media-amazon.com/images/I/synthetic2._AC_SL1500_.jpg"
    ],
    "availability": "In Stock",
    "reviews_count": null,
    "specifications": [
      {
        "group": "Product information",
        "name": "Brand Name",
        "value": "Synthetic"
      }
    ],
    "variations": [
      {
        "id": "B000000001",
        "title": "Blue",
        "url": "https://www.amazon.com/dp/B000000001",
        "category": "Color"
      }
    ]
  }
}

Missing, duplicate, unsupported or invalid parameters.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}