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:
  • valid and hidden flags from listing records.
  • locked status when active listing holds exist.
  • attachments array 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.