Bulk imports
Process submitted product page URLs as catalog or monitoring candidates.
Bulk product data API
Send arrays of product page URLs to dedicated bulk endpoints when stock checks or product information records need batch processing.
https://shop.example/p/123Use stock when availability, offers, price, seller, and delivery signals drive the workflow.
{
"productUrl": "https://shop.example/p/123"
}{
"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://shop.example/p/123"
}{
"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 |
|---|---|---|---|
| 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. |
| Bulk product information | POST /v1/product-information/bulk | { "items": [{ "productUrl": "https://shop.example/p/123" }] } | Collects product information for many product page URLs with per-item results. |
| Usage and credits | GET /v1/usage | No request body | Returns credit balance, rate class, limits, plan data, and recent usage rows for the authenticated token. |
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-information/bulk \
-H "Authorization: Bearer $PIA_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"items": [
{"productUrl": "https://shop.example/p/123"},
{"productUrl": "https://shop.example/p/456"}
]
}'// Node.js 18+, no packages. Run: PIA_API_TOKEN=your-token node bulk_product_information.mjs
const response = await fetch("https://api.productinformationapi.com/v1/product-information/bulk", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.PIA_API_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
items: [
{ productUrl: "https://shop.example/p/123" },
{ productUrl: "https://shop.example/p/456" },
],
}),
signal: AbortSignal.timeout(300_000),
});
const data = await response.json();
if (!response.ok) {
const { code, message, requestId } = data.error ?? {};
throw new Error(`${response.status} ${code}: ${message} (request ${requestId})`);
}
console.log(`${data.succeeded}/${data.total} succeeded, ${data.retryable} retryable`);
for (const { index, httpStatus, result } of data.results) {
if (httpStatus === 200) {
console.log(index, result.productInformation?.title);
} else {
console.log(index, httpStatus, result.error.code, result.error.retryable);
}
}# Python 3.8+ with requests (pip install requests). Run: PIA_API_TOKEN=your-token python bulk_product_information.py
import os
import requests
response = requests.post(
"https://api.productinformationapi.com/v1/product-information/bulk",
headers={"Authorization": f"Bearer {os.environ['PIA_API_TOKEN']}"},
json={"items": [
{"productUrl": "https://shop.example/p/123"},
{"productUrl": "https://shop.example/p/456"},
]},
timeout=300,
)
data = response.json()
if not response.ok:
error = data["error"]
raise SystemExit(f"{response.status_code} {error['code']}: {error['message']} (request {error['requestId']})")
print(f"{data['succeeded']}/{data['total']} succeeded, {data['retryable']} retryable")
for row in data["results"]:
result = row["result"]
if row["httpStatus"] == 200:
print(row["index"], (result.get("productInformation") or {}).get("title"))
else:
print(row["index"], row["httpStatus"], result["error"]["code"], result["error"]["retryable"]){
"requestId": "req_bulk_01HZX7",
"total": 2,
"succeeded": 2,
"failed": 0,
"retryable": 0,
"results": [
{
"index": 0,
"httpStatus": 200,
"result": {
"outcome": "OK",
"productInformation": {
"title": "Replacement water filter cartridge",
"brand": "AquaPro"
},
"creditsRemaining": 2479
}
},
{
"index": 1,
"httpStatus": 200,
"result": {
"outcome": "OK",
"productInformation": {
"title": "Replacement water filter cartridge, 4 pack",
"brand": "AquaPro"
},
"creditsRemaining": 2478
}
}
]
}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.
Process submitted product page URLs as catalog or monitoring candidates.
Refresh stock or product details for batches on a client-owned cadence.
Update product details for many existing records with per-item results.
Separate failed and retryable items without discarding successful responses.
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. Callers send productUrl for single requests or items[].productUrl for bulk requests. Internal identifiers are derived by the API when the URL is supported.
Use product-stock for availability and offers, and product-information for catalog details.
Yes. Dedicated stock and information bulk endpoints accept arrays of product page URLs and return per-item results.
Share target retailers or marketplaces, expected volume, required fields, and sample product URLs during onboarding.