Skip to main content
POST
Search Products

Authentication

All requests must include an API key via the X-API-Key header or api_key query parameter.

Rate Limits

When a rate limit is exceeded, the response has status 429 with a Retry-After header indicating seconds until reset.

Sorting

Pagination

  • page: 0-based page number (default: 0)
  • hitsPerPage: Results per page, max 100 (default: 20)

Response Format

Compatible with Algolia InstantSearch for drop-in frontend integration.
SearchHit[]
obrigatório
Array of matching products. Each hit includes _highlightResult with matched query terms wrapped in <em> tags.
integer
obrigatório
Total number of matching results across all pages.
integer
obrigatório
Current page number (0-based).
integer
obrigatório
Total number of pages.
integer
obrigatório
Number of results per page.
object
Facet counts per attribute and value. Only populated when facets is specified in the request.
integer
obrigatório
Query processing time in milliseconds.
string
Spell-corrected query string, present only when different from input.
Última modificação em 12 de março de 2026