GET /api/amazon/product/stock — Amazon Stock Estimates

Check the current stock availability of any Amazon product. The response tells you whether the item is in stock, the estimated number of units remaining, and the human-readable availability message shown to shoppers — useful for inventory monitoring, restock alerting, and competitor shelf-share analysis.

Request

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

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 (e.g. B09XS7JWHH). Provide at least one of asin, url, or gtin.

string

A full Amazon product URL. Provide at least one of asin, url, or gtin.

string

A Global Trade Item Number (barcode). Provide at least one of asin, url, or gtin.

Response

Stock information is returned under data.amazonProduct.stockEstimate.

object

Hide stockEstimate fields

string

The identifier of the offer this stock estimate applies to (typically the buybox winner).

boolean

required

true if the product is currently available for purchase.

integer

Estimated number of units remaining. A value of 0 indicates the item is out of stock. May be null when Amazon does not expose an exact count (e.g. for high-inventory items).

string

The availability text displayed to customers on the product page. Common values include:

"In Stock"
"Only 3 left in stock – order soon"
"Usually ships within 2–3 days"
"Currently unavailable"

Example Response

{
  "data": {
    "amazonProduct": {
      "stockEstimate": {
        "offerId": "offer_ATVP_B09XS7JWHH",
        "inStock": true,
        "stockLevel": 47,
        "availabilityMessage": "In Stock"
      }
    }
  }
}

Low-stock example

{
  "data": {
    "amazonProduct": {
      "stockEstimate": {
        "offerId": "offer_ATVP_B08N5WRW1X",
        "inStock": true,
        "stockLevel": 3,
        "availabilityMessage": "Only 3 left in stock – order soon"
      }
    }
  }
}

Out-of-stock example

{
  "data": {
    "amazonProduct": {
      "stockEstimate": {
        "offerId": "offer_ATVP_B07XJ8C8F5",
        "inStock": false,
        "stockLevel": 0,
        "availabilityMessage": "Currently unavailable"
      }
    }
  }
}

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/stock?asin=B09XS7JWHH&domain=US' \
  --header 'API-KEY: YOUR_API_KEY'

Products

Search & Discovery

Sellers & Categories

GET /api/amazon/product/stock — Amazon Stock Estimates

Request

Query Parameters

Response

Example Response

Low-stock example

Out-of-stock example

Error Handling

curl Example

​Request

​Query Parameters

​Response

​Example Response

​Low-stock example

​Out-of-stock example

​Error Handling

​curl Example

Request

Query Parameters

Response

Example Response

Low-stock example

Out-of-stock example

Error Handling

curl Example