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.