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.