Introduction – New Generation Product API

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.

Product Search

curl GET /api/v1/products/search

Search for products using text queries and LLM reranking.

Query Parameters

Parameter	Type	Description
q	string	Search query text (required)
brand_url	string	Base brand URL to filter by, e.g., nike.com (optional)
limit	number	Maximum number of results (default: 20)
include_raw_data	boolean	Include 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

Parameter	Type	Description
id	string	Product ID

Query Parameters

Parameter	Type	Description
include_raw_data	boolean	Include 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

Parameter	Type	Description
url	string	The product URL to fetch
include_raw_data	boolean	Include raw html/json data from pdp (default: false)

Health Check

GET /health

Check API health status.

Get Started

Endpoints

Product Search

Query Parameters

Get a Product by ID

Path Parameters

Query Parameters

Filter Products by URL

Query Parameters

Health Check

​Product Search

​Query Parameters

​Get a Product by ID

​Path Parameters

​Query Parameters

​Filter Products by URL

​Query Parameters

​Health Check

Product Search

Query Parameters

Get a Product by ID

Path Parameters

Query Parameters

Filter Products by URL

Query Parameters

Health Check