Mercari: Search
Mercari via Parse · marketplace
Search Mercari listings by keyword. Returns paginated results with item details including price, condition, brand, category, and images. Supports filtering by price range, item condition, item status (on sale vs sold), and sorting. Prices are in US dollars. Use offset for pagination; each response includes next_offset and has_more to drive continuation. The upstream caps total_count at 20000 even when more exist. Search for items on Mercari, the marketplace for used and secondhand goods. Fulfilled by Parse from www.mercari.com.
- ecommerce
- marketplace
- mercari
- parse
- platform-key
- reviews-ratings
- www-mercari-com
Price and execution
- Price
- $0.04 USD credits / call
- Trust tier
- Verified
- Execution
- Managed call
- Capability group
- marketplace
Interface snapshot
- Protocol
- HTTP operation
- Operation
- GET /scraper/affc7073-2b1c-42b2-8f89-f67489e32f69/search
- Interface artifact
- sha256:318bd95b0092af1e25259658d94c68677b83e2de19a2bef8e119715231bad1c0
- Manifest digest
- sha256:5221faca2e75644f62f872511771a9d0ac46c6fab4356c6d12ce623d3a2f8b53
Request fields
- limit (integer): Number of results per page, between 1 and 120.
- query (string, required): Search keyword (e.g. 'headphones', 'nike shoes').
- offset (integer): Pagination offset. Use the next_offset value from a previous response to get the next page.
- status (string): Item status filter. Omitted returns all items.
- sort_by (string): Sort order for results.
- condition (string): Comma-separated item condition filters (e.g. 'new,like_new'). Values: new, like_new, good, fair, poor.
- max_price (number): Maximum price filter in US dollars (e.g. 100 for $100.00).
- min_price (number): Minimum price filter in US dollars (e.g. 10 for $10.00).
- category_id (string): Mercari category ID to filter results (e.g. '789' for Headphones). Category IDs are returned in each item's category_hierarchy.
Example queries
- {"query":"headphones","sort_by":"best_match"}