API Reference
Search Mercari listings and get item detail, the home feed, autocomplete, and the full taxonomy as structured JSON. 5 endpoints documented below.
curl "https://api.crawlora.net/api/v1/mercari/search?query=nike+jacket" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora's Mercari endpoints read Mercari's mobile-app API anonymously and return listing search, item detail, the home feed, autocomplete, and the full taxonomy as normalized JSON. /mercari/master returned 3,233 categories, 28,825 brands, and 384 sizes on 2026-09-18, and search returns 100 listings in a single call.
/mercari/search takes a query and returns total_results (21,545 for nintendo switch) and 100 listing cards. Each card has id, URL, title, thumbnail, price_cents, original_price_cents, num_likes, seller_id, and created_at_unix and updated_at_unix timestamps.
A lower price_cents than original_price_cents marks a price drop; one Mario Kart case listing dropped from 900 to 810 cents. num_likes shows demand, and that listing had 796 likes. Unix timestamps let you measure how long listings stay up.
/mercari/item/{id} (ids look like m73669339323) returns the description, all photos, price, condition, category, hashtags, the shipping origin state, and a similar-items carousel. The title is the description's first line, and condition and category codes are decoded from Mercari's app data, so treat them as indicative.
/mercari/master and /mercari/home take no parameters. Fetch the taxonomy once and cache it. /mercari/autocomplete gives Mercari's own phrasing; nintendo suggests nintendoswitch 2.
/mercari/autocompleteapiKey1 credit/requestReturns Mercari's own search-suggestion list for a partial keyword, in its own relevance order. An empty suggestion list is a normal outcome for obscure or gibberish input.
Required: query.
/mercari/homeapiKey3 credits/requestReturns Mercari's own curated home-feed recommendations: listing summaries (title, price, thumbnail, condition, seller).
Takes no parameters.
Sampled 14 Oct 2026: 240 items. Filled in every item: id, url, title, thumbnail_url, price_cents, num_likes, seller_id, created_at_unix. Not in every item: condition_code (161). In the sample: created_at_unix: 2026-08-31 to 2026-09-02; price_cents: 3,000 to 49,900, median 4,999; title: “Vintage coach wallet” and 239 other values; url: mercari.com; thumbnail_url: u-mercari-images.mercdn.net; num_likes: 33 to 3,510, median 730.
/mercari/item/{id}apiKey3 credits/requestReturns a Mercari item-detail page: description, all photos, price, condition, category, hashtags, the shipping origin state, and a "similar items" carousel of related listings.
Required: id.
Sampled 14 Oct 2026: 50 items. Filled in every item: id, url, title, thumbnail_url, price_cents, num_likes, seller_id, created_at_unix. Not in every item: updated_at_unix (20), condition_code (32). In the sample: created_at_unix: 2022-07-09 to 2026-10-12; price_cents: 525 to 8,500, median 2,175; title: “Wilson SPS Nemesis Graphite Tennis Racquet” and 49 other values; url: mercari.com; thumbnail_url: u-mercari-images.mercdn.net; num_likes: 17 to 1,984, median 236; updated_at_unix: 2026-05-08 to 2026-06-03.
/mercari/masterapiKey1 credit/requestReturns Mercari's full reference taxonomy in one call: every category (with parent linkage), every recognized brand, and every clothing/shoe/apparel size. Large (tens of thousands of brand entries) and effectively static -- cache this response rather than polling it.
Takes no parameters.
Sampled 14 Oct 2026: 28853 items. Not in every item: id (500), name (500). In the sample: name: “104+ Octane Boost” and 499 other values.
/mercari/searchapiKey3 credits/requestSearches Mercari's live resale marketplace by free-text keyword, returning listing summaries (title, price, thumbnail, condition, seller) plus the total matching count.
Required: query.
Sampled 14 Oct 2026: 100 items. Filled in every item: id, url, title, thumbnail_url, price_cents, num_likes, seller_id, created_at_unix and 1 more. Not in every item: original_price_cents (77). In the sample: created_at_unix: 2024-02-13 to 2026-10-12; price_cents: 568 to 15,011, median 2,422; title: “Nike 24m jacket lsu vguc” and 94 other values; url: mercari.com; thumbnail_url: u-mercari-images.mercdn.net; num_likes: 59 to 1,984, median 360; updated_at_unix: 2026-04-21 to 2026-10-13; original_price_cents: 1,000 to 19,400, median 3,000.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| Mercari search autocomplete | GET /mercari/autocomplete?query=nike | 99.9% | 1.92 s |
| Get Mercari home feed | GET /mercari/home | 99.9% | 2.92 s |
| Get Mercari item detail | GET /mercari/item/m68304972636 | 99.9% | 2.32 s |
| Get Mercari full taxonomy (categories, brands, sizes) | GET /mercari/master | 99.8% | 3.21 s |
| Search Mercari listings | GET /mercari/search?query=nike+jacket | 99.9% | 2.51 s |