Listings
Search all live listings
Search public listings using free-text terms, facet filters, sorting, and pagination.
Use this endpoint for marketplace browse pages, category landing pages, and search-result views.
What it does:
- Applies your query text and facet filters against public listing data.
- Returns only listings with available stock (
available > 0). - Enriches each hit with seller summary data, lock status, and attachment URLs.
Performance and caching:
- Results are cached briefly (~30 seconds) for fast repeat searches.
- The cache key is based on the request body, so different filter sets are isolated.
POST
Body
application/json
A search query includes a free text query property, refinements in the form of facets, pagination controls and optional sorting.
One or more free text search terms
Facets to refine the search results. Values are case-sensitive unless noted otherwise.
Offset for pagination
Number of results to return
Required range:
1 <= x <= 50Sort results by field and order