API Referencev3
Get Catalog Item
GET /v3/catalog/items/:id — Retrieve a specific catalog item by ID.
GET https://api.pricehero.ai/v3/catalog/items/:id
Legacy path: GET /api/v3/catalog/items/:id (same behavior).
Returns one catalog row in the same shape as Search catalog: id, name, popularity, images, thumbnails, plus response-level includes and resolved_taxonomy. attributes and per-variant fields are present only when includes contains taxonomy. variants is present only for product rows.
Request
curl "https://api.pricehero.ai/v3/catalog/items/product_abc123?includes=taxonomy,pricing" \
-H "Authorization: Bearer ph_test_YOUR_KEY"Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✅ | Catalog item ID (from search or vision) |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
includes | string | — | Comma-separated: taxonomy, pricing only (default taxonomy) |
Response
Same envelope as catalog search: success, results, total_results, page, total_pages, credits_used, includes, resolved_taxonomy, data (array of one item).
Credits
404 responses do not consume credits. See Credits.