Skip to main content
GET
Search Products

Authorizations

Authorization
string
header
required

Zinc API key (Bearer zn_...)

Headers

authorization
string | null

Query Parameters

query
string
required

Search term

retailer
enum<string>
required

Retailer identifier

Available options:
amazon,
walmart
page
integer | null

Page number for pagination

free_shipping
boolean
default:false

Only return items that ship for free (Walmart: ship price of 0). Currently a no-op for Amazon: the upstream search data under-reports Prime, so filtering on it would drop valid items — Amazon results are returned unfiltered. Filtering happens after v1 pagination, so per-page counts vary; use next_page in the response to keep paging — an empty page with a non-null next_page is not the end of results.

Response

Successful Response

Response from the product search endpoint.

status
string
required
results
ProductSearchResult · object[]
next_page
integer | null

Only set on free_shipping searches: the page to request to keep paging. An empty results with a non-null next_page is NOT the end of results — request next_page to continue. None means results are exhausted (or the search was unfiltered).