Search your listings
Search the authenticated seller’s listings using full-text query and facets.
This endpoint is optimized for seller backoffice listing management views.
Search behavior:
- Executes against the listings search index with seller-scoped filtering.
- The API enforces seller ownership by injecting the authenticated seller facet server-side.
- Additional user-provided facets are merged with seller scoping.
Response enrichment:
- Returns indexed listing hits plus seller-specific metadata from the primary database.
- Adds:
validandhiddenflags from listing records.lockedstatus when active listing holds exist.attachmentsarray with public URLs.
Authentication:
- Caller must map to an existing seller account.
Use this endpoint when you need filterable, paginated, relevance-aware listing search for the current seller.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
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
1 <= x <= 50Sort results by field and order