All API endpoints are protected with API key authentication. You must include a valid API key in the Authorization header with each request. Email us and we’ll help you get set up.
curl GET /api/v1/products/search
Search for products using text queries and LLM reranking.

​
Query Parameters

ParameterTypeDescription
qstringSearch query text (required)
brand_urlstringBase brand URL to filter by, e.g., nike.com (optional)
limitnumberMaximum number of results (default: 20)
include_raw_databooleanInclude raw html/json data from pdp (default: false)

​
Get a Product by ID

curl GET /api/v1/products/:id
Retrieve a product by its ID.

​
Path Parameters

ParameterTypeDescription
idstringProduct ID

​
Query Parameters

ParameterTypeDescription
include_raw_databooleanInclude raw html/json data from pdp (default: false)

​
Filter Products by URL

curl GET /api/v1/products?url={url}
Retrieve a product by its URL.

​
Query Parameters

ParameterTypeDescription
urlstringThe product URL to fetch
include_raw_databooleanInclude raw html/json data from pdp (default: false)

​
Health Check

GET /health
Check API health status.