Search a seller's listings
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
idpath parameter accepts either a user ID or a username. - Returns
404when 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
Search a seller's listings
Path Parameters
User ID or username of the seller
Minimum string length:
1Body
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