Developer Center · API

Search API

Handle search as an explicit contract: query, store context, filters, sorting, pagination and errors should be predictable throughout the storefront.

Query & context

Explicitly send the input and the correct store context so that results do not mix over stores or markets.

Use structured facet names and values and keep URL state and request state aligned.

Handle sorting choices and result cuts as part of the same request contract.

Distinguish between invalid input, authentication, temporary errors and timeouts.