Discovery API
Canonical listings discovery and optional catalog product embed.
Discovery API
Canonical buyer discovery: GET /v1/listings (and related /v1/listings/* routes).
GET /v1/services remains a deprecated thin adapter — new clients should use listings.
Catalog product embed
| Param | Values | Effect |
|---|---|---|
include | product, catalog, or catalog_product | Each listing may include catalog_product |
Applies to listing list/detail/collection/featured helpers and map points (include_catalog=true or include=product).
Example:
GET /v1/listings?include=product
Authorization: Bearer <jwt>
See the OpenAPI API reference for full query parameters (geo, tier, pagination).