Mercari active listings

Search Mercari US listings that are for sale now. Each call returns one page of up to 100 rows, in the order you pick with sort.

displayed_price is the price Mercari shows. listed_at is when the listing was created. displayed_shipping and shipping_text are always null, because we can't verify Mercari's shipping amounts. promoted, bid_count, ends_at, best_offer and location_text are always null too. format is always fixed_price.

condition is Mercari's label, like Like New, and condition_id is its number. Rows also have Mercari's seller, category and brand IDs. brand and size are always null, because Mercari search doesn't return those names. Listings with a sale in progress are left out.

curl -G https://api.soldgraph.com/v1/mercari/listings \  -H "Authorization: Bearer $SOLDGRAPH_KEY" \  --data-urlencode "q=sony headphones" \  -d page=1 \  -d count=25

The first call usually returns 202 and a job to poll. Search jobs covers polling and retries.

#Filters and sorting

• condition takes one Mercari condition: new, like_new, good, fair or poor.
• min_price and max_price are whole US dollars. You can send either one alone.
• category_id and brand_id are Mercari's numeric IDs.
• count sets the most rows per page, from 1 to 100.
• sort is best_match (default), newest, price_asc, price_desc or most_popular. newest orders by when the listing was created.

Mercari applies the filters, so reported_total counts only matching listings. Keep the same filters, sort and count on every page.

#Pages and cursors

Start with page=1 and no cursor. For the next page, send page set to next_page and cursor set to next_cursor from the last result.

• A later page without a cursor, a cursor from a different search, or a cursor in the wrong format returns 422.
• When next_cursor is null, you're on the last page. You can request at most 100 pages.
• page_size counts the rows Mercari returned before we removed listings that aren't for sale. So count can be smaller.
• Results are in the order you pick with sort. reported_total may be capped.
• The same listing can show up on more than one page. Deduplicate by id when you combine pages.

The dashboard Playground has Next page and Start over buttons that handle cursors for you.

#Example response

{  "request_id": "00000000-0000-4000-8000-000000000001",  "status": "complete",  "credits": 1,  "cached": false,  "result": {    "provider": "mercari",    "country": "us",    "query": "sony headphones",    "page": 1,    "page_size": 1,    "count": 1,    "reported_total": 1,    "next_page": null,    "collected_at": "2026-09-23T14:02:11Z",    "schema_version": 1,    "completeness": "provider_page_only",    "data": [      {        "id": "m00000000001",        "title": "Illustrative Sony headphones listing",        "link": "https://www.mercari.com/us/item/m00000000001/",        "promoted": null,        "format": "fixed_price",        "displayed_price": {          "amount": 42,          "currency": "USD"        },        "displayed_price_text": "$42.00",        "displayed_shipping": null,        "shipping_text": null,        "condition": "Good",        "brand": null,        "size": null,        "listed_at": "2026-09-27T10:04:12-07:00",        "bid_count": null,        "ends_at": null,        "best_offer": null,        "seller_text": "123456789",        "location_text": null,        "image": null,        "condition_id": 3,        "brand_id": 1,        "category_id": 1594,        "seller_id": "123456789",        "status": "active"      }    ],    "field_notes": "Displayed prices are marketplace listing amounts, not independently verified transaction or accepted-offer amounts. Sold timestamps are source-reported and may be absent. Trading items are excluded. Brand/category IDs are source IDs; labels and size are null. Reported totals may be capped. Results cover one source page only.",    "next_cursor": null  }}

curl -G https://api.soldgraph.com/v1/mercari/listings \  -H "Authorization: Bearer $SOLDGRAPH_KEY" \  --data-urlencode "q=sony headphones" \  -d count=25