v14

OpenAPI 3.1.02026-08-03122113375.9 KB
listings

Search a seller's listings

Search listings that belong to a specific seller.

Use this endpoint for seller storefront pages, seller profile inventory tabs, and seller-specific search experiences.

Seller targeting:

  • The id path parameter accepts either a user ID or a username.
  • Returns 404 when the seller cannot be found.

Search behavior:

  • Applies your query text/facets plus an enforced filter for that seller.
  • Returns only listings with available stock (available > 0).
  • Enriches hits with seller profile, listing lock status, and attachment URLs.

Performance:

  • Uses short-lived body-signature caching for repeated seller searches.
post/listings/seller/{id}

Path parameters

idstring required

User ID or username of the seller

User ID or username of the seller

Request body

querystring

One or more free text search terms

filtersobject[]
fromnumber nullable

Offset for pagination

sizenumber

Number of results to return