Seller checks
Identify seller values returned with supported Amazon offers.
Amazon offers
Use the stock endpoint for offer-oriented Amazon fields, including seller, fulfilment, delivery, price, and currency signals.
https://www.amazon.co.uk/dp/B0EXAMPLE1Use 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. |
Code examples
Put your API token in PIA_API_TOKEN, replace the example URL with a product page from a supported store, and run the snippet. API tokens are in your account console.
Errors return error.code, error.message, error.requestId, and error.retryable. When retryable is true, wait for the Retry-After seconds, then send the request again. Only successful requests use credits.
The OpenAPI reference lists every field and status code.
curl -sS https://api.productinformationapi.com/v1/product-stock \
-H "Authorization: Bearer $PIA_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"productUrl": "https://www.amazon.co.uk/dp/B0EXAMPLE1"}'// Node.js 18+, no packages. Run: PIA_API_TOKEN=your-token node stock.mjs
const response = await fetch("https://api.productinformationapi.com/v1/product-stock", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.PIA_API_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ productUrl: "https://www.amazon.co.uk/dp/B0EXAMPLE1" }),
signal: AbortSignal.timeout(150_000),
});
const data = await response.json();
if (!response.ok) {
const { code, message, requestId } = data.error ?? {};
throw new Error(`${response.status} ${code}: ${message} (request ${requestId})`);
}
const [offer] = data.offers;
console.log({
inStock: data.inStock,
offerCount: data.offerCount,
price: offer?.price,
currency: offer?.currency,
seller: offer?.seller,
});# Python 3.8+ with requests (pip install requests). Run: PIA_API_TOKEN=your-token python stock.py
import os
import requests
response = requests.post(
"https://api.productinformationapi.com/v1/product-stock",
headers={"Authorization": f"Bearer {os.environ['PIA_API_TOKEN']}"},
json={"productUrl": "https://www.amazon.co.uk/dp/B0EXAMPLE1"},
timeout=150,
)
data = response.json()
if not response.ok:
error = data["error"]
raise SystemExit(f"{response.status_code} {error['code']}: {error['message']} (request {error['requestId']})")
offer = data["offers"][0] if data["offers"] else {}
print({
"inStock": data["inStock"],
"offerCount": data["offerCount"],
"price": offer.get("price"),
"currency": offer.get("currency"),
"seller": offer.get("seller"),
})Response fields
Exact fields depend on the endpoint, the product page, and the store's coverage.
Use cases
Typical jobs teams build on these endpoints.
Identify seller values returned with supported Amazon offers.
Review fulfilment and delivery fields when offer quality matters.
Compare price, currency, seller, and delivery data against internal rules.
Use offer fields to support marketplace operations and exception handling.
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
Answers to the questions teams ask before they integrate.
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.