Endpoint catalog
Search public products
GET /api/v1/search
GET /api/v1/search
- operationId:
searchPublicProducts - Stability: stable
- Authentication: None
- Idempotency: none
Parameters
| Name | In | Required | Type |
|---|---|---|---|
q | query | Yes | string |
locale | query | Yes | string |
market | query | Yes | string |
category | query | No | string |
merchant | query | No | string |
sort | query | Yes | string |
page | query | Yes | integer |
pageSize | query | Yes | integer |
Request body
This operation declares no request body.
Responses and errors
| Status | Description | Schema |
|---|---|---|
200 | Successful response | #/components/schemas/PublicProductSearchResponse |
400 | Request does not match the public contract | #/components/schemas/PublicErrorResponse |
401 | Authentication failed | #/components/schemas/PublicErrorResponse |
403 | Insufficient authorization scope | #/components/schemas/PublicErrorResponse |
404 | Public resource not found | #/components/schemas/PublicErrorResponse |
409 | Idempotency or state conflict | #/components/schemas/PublicErrorResponse |
429 | Rate limited | #/components/schemas/PublicErrorResponse |
Rate limiting
The spec declares a 429 response.
The Retry-After header is not declared by the spec.
- Top-level shape:
{ data: array, meta?: object }
Success response schema
{
"$ref": "#/components/schemas/PublicProductSearchResponse"
}
Error response schema
{
"$ref": "#/components/schemas/PublicErrorResponse"
}
Generated from the verified public-only OpenAPI artifact; no speculative request example is provided.