Stock checks
Check whether supported Amazon product URLs have available offers.
Amazon stock API
Use the stock endpoint for Amazon availability and offer signals when target product URL coverage is enabled.
https://www.amazon.co.uk/dp/B0EXAMPLE1 Use stock when availability, offers, price, seller, and delivery signals drive the workflow.
{
"productUrl": "https://www.amazon.co.uk/dp/B0EXAMPLE1"
} {
"externalId": "B0EXAMPLE1",
"source": "amazon_gb",
"method": "checkStock",
"outcome": "OK",
"inStock": true,
"offerCount": 2,
"offers": [
{
"price": 49.95,
"currency": "GBP",
"seller": "AquaPro",
"fulfilment": "FBA",
"deliveryDays": 2
},
{
"price": 54.99,
"currency": "GBP",
"seller": "PartsHub",
"fulfilment": "FBM",
"deliveryDays": 4
}
],
"cacheStatus": "live",
"creditsRemaining": 4871
} Use product information when catalog, enrichment, onboarding, or content-quality workflows need structured details.
{
"productUrl": "https://www.amazon.co.uk/dp/B0EXAMPLE1"
} {
"productInformation": {
"title": "Replacement water filter cartridge",
"brand": "AquaPro",
"images": [
"https://cdn.example/products/water-filter-123/main.jpg"
],
"attributes": {
"capacity": "1 liter",
"packSize": "2"
},
"ratings": {
"average": 4.6,
"reviewCount": 1284
}
},
"creditsRemaining": 2480
} API reference
Single requests send productUrl. Bulk requests send
items[].productUrl. Bearer auth is required for product and usage routes.
| Use case | Endpoint | Request body | Returns |
|---|---|---|---|
| Check stock | POST /v1/product-stock | { "productUrl": "https://shop.example/p/123" } | Returns availability, offer count, price, currency, seller, fulfilment, and delivery fields for one product page URL. |
| Bulk stock checks | POST /v1/product-stock/bulk | { "items": [{ "productUrl": "https://shop.example/p/123" }] } | Runs stock checks for many product page URLs and returns per-item status. |
Example
Use this page’s example to confirm the body shape, expected response fields, and endpoint mapping before copying language-specific code from the OpenAPI reference.
{
"productUrl": "https://www.amazon.co.uk/dp/B0EXAMPLE1"
} {
"externalId": "B0EXAMPLE1",
"source": "amazon_gb",
"method": "checkStock",
"outcome": "OK",
"inStock": true,
"offerCount": 2,
"offers": [
{
"price": 49.95,
"currency": "GBP",
"seller": "AquaPro",
"fulfilment": "FBA",
"deliveryDays": 2
},
{
"price": 54.99,
"currency": "GBP",
"seller": "PartsHub",
"fulfilment": "FBM",
"deliveryDays": 4
}
],
"cacheStatus": "live",
"creditsRemaining": 4871
} Response fields
Exact fields depend on endpoint, product page URL, and enabled coverage, but these are the fields this page is designed around.
Use cases
Each page targets a distinct workflow, field set, or buying question.
Check whether supported Amazon product URLs have available offers.
Trigger alerts when in-stock status or offer count changes.
Watch the number of returned offers for operational review.
Pair stock signals with product details during onboarding or refreshes.
Limitations
Coverage is enabled by supported retailer, marketplace, and product page URL.
Polling cadence belongs to the client integration and is discussed during onboarding.
The API is not an official marketplace partner API and does not promise unlimited collection.
FAQ
Visible answers are mirrored in structured data for eligible generated pages.
No. It is an independent product data API that can support Amazon-related workflows where coverage is enabled.
No. Send the Amazon product URL. The API derives supplier keys internally when the URL is supported.
Yes. Use the stock endpoint for availability and offers, and the information endpoint for product details.
Yes. Use the bulk stock or bulk information endpoint with items[].productUrl.