Mercari Scraper logo

Mercari Scraper API

Search Mercari listings, read item details, and explore seller profiles, inventory, and reviews as structured JSON for resale research and price comparisons.

API Endpoints

Available endpoints for the Mercari Scraper API

POST /v1/mercari/listing

Mercari Listing API

Get a Mercari US listing’s title, price, photos, condition and seller name.

Parameters

url string required Mercari US item URL.
POST /v1/mercari/search

Mercari Search API

Search Mercari US listings with price, brand, category, condition and status filters. Follow next_cursor to get more results.

Parameters

brand_ids array Mercari brand IDs. Results include brand_id for subsequent filtering.
category_ids array Mercari category IDs. Results include category_id for subsequent filtering.
conditions array Include listings in these conditions.
cursor string Opaque next_cursor from the previous response. Keep the same seller, query, filters, and limit.
limit integer Maximum results to return. Review pages may return fewer than this limit.
max_price number Maximum item price in US dollars, excluding shipping and fees.
min_price number Minimum item price in US dollars, excluding shipping and fees.
query string Search keywords.
sort string Order results by relevance, listing date, price, or sale recency.
status string Listing status. Sold includes completed and in-progress sales; displayed prices are not guaranteed final transaction prices.
url string Copy a filtered Mercari search URL to reuse brand, category, condition and price filters without looking up IDs.
POST /v1/mercari/seller

Mercari Seller API

Get a public Mercari US seller profile, ratings, follower counts and selling statistics.

Parameters

seller_id string Mercari seller ID, returned by search or seller listings.
url string Public Mercari US seller profile URL.
username string Public Mercari username.
POST /v1/mercari/seller/listings

Mercari Seller Listings API

Get a Mercari US seller’s listings with keyword, price, brand, category, condition and status filters. Follow next_cursor to get more results.

Parameters

brand_ids array Mercari brand IDs. Results include brand_id for subsequent filtering.
category_ids array Mercari category IDs. Results include category_id for subsequent filtering.
conditions array Include listings in these conditions.
cursor string Opaque next_cursor from the previous response. Keep the same seller, query, filters, and limit.
filters_url string Copy a filtered Mercari search URL to reuse brand, category, condition and price filters without looking up IDs.
limit integer Maximum results to return. Review pages may return fewer than this limit.
max_price number Maximum item price in US dollars, excluding shipping and fees.
min_price number Minimum item price in US dollars, excluding shipping and fees.
query string Optional keywords within this seller’s listings.
seller_id string Mercari seller ID, returned by search or seller listings.
sort string Order results by relevance, listing date, price, or sale recency.
status string Listing status. Sold includes completed and in-progress sales; displayed prices are not guaranteed final transaction prices.
url string Public Mercari US seller profile URL.
username string Public Mercari username.
POST /v1/mercari/seller/reviews

Mercari Seller Reviews API

Get public Mercari US account feedback, newest first. Choose reviews from buyers or sellers. Automated Mercari messages are labelled.

Parameters

cursor string Opaque next_cursor from the previous response. Keep the same seller, query, filters, and limit.
limit integer Maximum results to return. Review pages may return fewer than this limit.
review_type string Buyers reviews assess this account as a seller; sellers reviews assess it as a buyer.
seller_id string Mercari seller ID, returned by search or seller listings.
url string Public Mercari US seller profile URL.
username string Public Mercari username.

Start scraping Mercari

Get your free API key