API Referencev3
API Reference Overview
Complete reference for Price Hero API v3 — the current, recommended version.
Use the version dropdown above API Reference in the sidebar to switch between v3 (this section), v2, and v1. The links under API Reference update to match. v3 is the default for new integrations; v1 and v2 are documented as legacy.
The Price Hero API is organized around REST. It accepts JSON request bodies, returns JSON responses, and uses standard HTTP status codes.
Base URL: https://api.pricehero.ai
Endpoints
| Method | Path | Description |
|---|---|---|
POST | /v3/catalog/query | Search catalog by text query |
GET | /v3/catalog/items/:id | Retrieve a specific catalog item |
POST | /v3/vision/identify | Identify an item from an image |
See the pages in this section for full request and response details:
Try the API
The interactive API Explorer (try requests against the live API with your keys) is in the developer portal. You need to be signed in as a developer.
Versioning
| Version | Status | Notes |
|---|---|---|
v3 | Current | Full feature set, recommended — this documentation set |
v2 | Legacy | POST /api/v2/products — transitional; see v2 docs |
v1 | Legacy | GET /api/v1/products — limited access; see v1 docs |
All new integrations should use v3.