GET /api/amazon/product — Fetch Amazon Product Data

Fetch complete product data for any Amazon listing. You can look up a product by its ASIN, a full Amazon product URL, or a GTIN barcode. The response includes pricing, images, ratings, feature bullets, technical specifications, category breadcrumbs, and the active seller — everything you need to build rich product displays or power downstream analytics.

Request

GET https://api.glade.dev/api/amazon/product

Query Parameters

string

default:"US"

The Amazon marketplace to query. Accepted values: US UK CA DE FR IT ES AU IN MX BR JP PL. Defaults to US when omitted.

string

The Amazon Standard Identification Number — a 10-character alphanumeric identifier (e.g. B08N5WRWNW). Provide at least one of asin, url, or gtin.

string

A full Amazon product URL (e.g. https://www.amazon.com/dp/B08N5WRWNW). Provide at least one of asin, url, or gtin.

string

A Global Trade Item Number (barcode), such as a UPC or EAN. Provide at least one of asin, url, or gtin.

Response

The product details are nested under data.amazonProduct.

object

Hide amazonProduct fields

string

required

The full product title as displayed on Amazon.

string

An optional subtitle or tagline shown beneath the main title.

string

The brand name associated with the product.

string

The canonical Amazon URL for this product listing.

string

The product’s ASIN, matching the pattern ^[A-Z0-9]{10}$.

boolean

true if the product is eligible for Amazon Prime shipping.

boolean

true if the product condition is listed as new.

boolean

true if the product is currently available to purchase.

object

Show price fields

string

Currency symbol, e.g. $.

number

Numeric price value, e.g. 29.99.

string

ISO 4217 currency code, e.g. USD.

string

Human-readable price string, e.g. $29.99.

string

URL of the primary product image.

string[]

Array of all available product image URLs.

number

Average customer rating on a 0–5 scale.

integer

Total number of customer ratings.

string[]

Array of the product’s key feature bullet points.

object[]

Show technicalSpecification item

string

Specification label, e.g. Battery Life.

string

Specification value, e.g. 20 hours.

object[]

Show category item

string

Amazon category node ID.

string

Display name of the category.

string

URL to the category browse page.

Full breadcrumb path, e.g. Electronics > Headphones.

object | null

Show coupon fields

string

Coupon label text, e.g. Save 10% with coupon.

object | null

Show seller fields

string

Unique Amazon seller identifier.

string

Seller display name.

Example Response

{
  "data": {
    "amazonProduct": {
      "title": "Sony WH-1000XM5 Wireless Industry Leading Noise Canceling Headphones with Auto Noise Canceling Optimizer",
      "subtitle": "Industry-leading noise cancellation",
      "brand": "Sony",
      "url": "https://www.amazon.com/dp/B09XS7JWHH",
      "asin": "B09XS7JWHH",
      "isPrime": true,
      "isNew": true,
      "isInStock": true,
      "price": {
        "symbol": "$",
        "value": 279.99,
        "currency": "USD",
        "display": "$279.99"
      },
      "mainImageUrl": "https://m.media-amazon.com/images/I/51aXvjzcukL._AC_SL1500_.jpg",
      "imageUrls": [
        "https://m.media-amazon.com/images/I/51aXvjzcukL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/61VGGe0dKWL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71o8Q5XJS5L._AC_SL1500_.jpg"
      ],
      "rating": 4.4,
      "ratingsTotal": 18423,
      "featureBullets": [
        "Industry-leading noise canceling with Integrated Processor V1",
        "Exceptional sound quality with the HD Noise Canceling Processor QN1",
        "Up to 30-hour battery life with quick charging (3 min charge = 3 hours playback)",
        "Crystal clear hands-free calling with 4 beamforming microphones",
        "Multipoint connection — connect to two Bluetooth devices simultaneously"
      ],
      "technicalSpecifications": [
        { "name": "Connectivity Technology", "value": "Bluetooth, 3.5mm Jack" },
        { "name": "Battery Life", "value": "30 Hours" },
        { "name": "Driver Size", "value": "30mm" },
        { "name": "Weight", "value": "250g" },
        { "name": "Color", "value": "Black" }
      ],
      "categories": [
        {
          "id": "172541",
          "name": "Over-Ear Headphones",
          "url": "https://www.amazon.com/b?node=172541",
          "breadcrumbPath": "Electronics > Headphones, Earbuds & Accessories > Headphones & Earbuds > Over-Ear Headphones"
        }
      ],
      "coupon": {
        "label": "Save $20.00 with coupon"
      },
      "seller": {
        "sellerId": "ATVPDKIKX0DER",
        "name": "Amazon.com"
      }
    }
  }
}

Error Handling

All errors follow a consistent envelope. The HTTP status code mirrors the code field inside the errors array.

Status	Meaning
`400`	Bad request — a required parameter is missing or malformed.
`401`	Unauthorized — your API key is missing or invalid.
`402`	Payment required — your plan limit has been reached.
`429`	Too many requests — you have exceeded the rate limit for your plan.
`502`	Bad gateway — Amazon returned an unexpected response; retry with exponential back-off.

{
  "success": false,
  "errors": [
    {
      "code": 400,
      "message": "Missing required parameter: asin, url, or gtin must be provided"
    }
  ]
}

curl Example

curl --request GET \
  --url 'https://api.glade.dev/api/amazon/product?asin=B09XS7JWHH&domain=US' \
  --header 'API-KEY: YOUR_API_KEY'

Products

Search & Discovery

Sellers & Categories

GET /api/amazon/product — Fetch Amazon Product Data

Request

Query Parameters

Response

Example Response

Error Handling

curl Example

​Request

​Query Parameters

​Response

​Example Response

​Error Handling

​curl Example

Request

Query Parameters

Response

Example Response

Error Handling

curl Example