Resale pricing and inventory research
Mercariエンドポイントを使えば、「Resale pricing and inventory research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Turn public Mercari pages into structured resale-marketplace data — keyword listing search, full item detail with photos and pricing, the curated home feed, search autocomplete, and the complete category/brand/size taxonomy, all as normalized JSON. Credential-free.
Search Mercari listings and get item detail, the home feed, autocomplete, and the full taxonomy as structured JSON.
エンドポイントファミリー
5
ドキュメント化されたパラメータ
8
サンプル数
5
ライブカタログスナップショット
稼働エンドポイント
5
メソッド
GET
必須パラメータ
8
スキーマ参照
5
{
"platform": "Mercari",
"endpoint": "mercari-search",
"method": "GET",
"path": "/mercari/search",
"auth": "apiKey"
}ユースケース
Search Mercari listings and get item detail, the home feed, autocomplete, and the full taxonomy as structured JSON.
Mercariエンドポイントを使えば、「Resale pricing and inventory research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Mercariエンドポイントを使えば、「Listing and category monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Mercariエンドポイントを使えば、「Marketplace demand tracking」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のMercariエンドポイントカタログから取得しています（エンドポイント5件、ドキュメント化されたリクエストパラメータ8個、公開レスポンススキーマ5件）。DocsとPlaygroundが参照しているカタログと同じものです。
Mercariのエンドポイントは5件、5つのリクエストファミリーに分類されています（Autocomplete、Home、Itemほか2件）。
これらのMercariエンドポイントには8個のリクエストパラメータがドキュメント化されており、うち8個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
5件のMercariエンドポイントのうち5件が実際のサンプルレスポンスを、5件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Mercariのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、500、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Mercariのエンドポイントは5個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
/mercari/autocomplete
/mercari/home
/mercari/item/{id}
/mercari/master
/mercari/search
エンドポイントカタログ
/mercari/searchSearches Mercari's live resale marketplace by free-text keyword, returning listing summaries (title, price, thumbnail, condition, seller) plus the total matching count.
レスポンスに関する注記
- `total_results` reflects Mercari's full matching-result count for the query, not just `len(items)` (this endpoint returns the first page). - `original_price_cents`, `num_likes`, and `condition_code` are omitted from an item when Mercari's response doesn't include them for that listing. - `condition_code` and `num_likes` are best-effort field labels, recovered by decoding raw upstream responses rather than from a published schema — treat them as directionally useful, not authoritative. - A search with no matching listings returns `200` with `"items": []`. - A missing `query` returns `400` before any upstream request is made.
MCPツール mercari_search
/mercari/item/{id}Returns a Mercari item-detail page: description, all photos, price, condition, category, hashtags, the shipping origin state, and a "similar items" carousel of related listings.
レスポンスに関する注記
- `title` is the item's description text up to its first line break — Mercari's mobile API does not expose a separate, shorter title field at this response's top level; `description` is the full text. - `condition_code` and `category_code` are best-effort field labels, recovered by decoding raw upstream responses rather than from a published schema — treat them as directionally useful, not authoritative. - `similar_items` is a list of related listings in the same shape as `/mercari/search`'s `items` array (title, price, thumbnail, condition, seller). It is omitted (not an error) when Mercari's response doesn't include a similar-items carousel for that listing, and it never includes the requested item itself. - An unknown or delisted item id returns `404`. - A missing `id` returns `400` before any upstream request is made.
MCPツール mercari_item
/mercari/homeReturns Mercari's own curated home-feed recommendations: listing summaries (title, price, thumbnail, condition, seller).
レスポンスに関する注記
- `original_price_cents`, `num_likes`, and `condition_code` are omitted from an item when Mercari's response doesn't include them for that listing. - `condition_code` and `num_likes` are best-effort field labels, recovered by decoding raw upstream responses rather than from a published schema — treat them as directionally useful, not authoritative. - Mercari's upstream response carries two parallel item carousels; this endpoint surfaces only the larger, primary one.
MCPツール mercari_home
/mercari/autocompleteReturns 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.
レスポンスに関する注記
- `suggestions` is an empty array (not an error) when Mercari has nothing to suggest for sufficiently obscure or gibberish input — a true "nothing matched" outcome. - A missing `query` returns `400` before any upstream request is made.
MCPツール mercari_autocomplete
/mercari/masterReturns 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.
レスポンスに関する注記
- This is a large response — tens of thousands of brand entries. It is effectively static day to day; the endpoint is served with a 24-hour edge cache, so repeated calls do not re-fetch from Mercari each time. - `categories` is a flat list with `parent_id` linkage rather than a nested tree, matching the shape Mercari's own data uses. `parent_id` is omitted (zero) for a top-level category (e.g. "Women", "Men", "Home"); `icon_url` is only populated for top-level categories. - `sizes` is one flat list spanning all size-bearing categories — it is not scoped per-category. `short_name` and `code` are the two parts a size's `name` is composed from when both are present (e.g. name `"XS (0-2)"` = short_name `"XS"` + code `"(0-2)"`); either may be absent when Mercari's own data doesn't split them out. Example response (truncated — the real response has ~3,000 categories, ~28,000 brands, and ~380 sizes): ```json { "code": 200, "msg": "OK", "data": { "categories": [ { "id": 1, "name": "Women", "icon_url": "https://u-mercari-images.mercdn.net/assets/img/home_categories/1.png" }, { "id": 11, "name": "Dresses", "parent_id": 1 } ], "brands": [ { "id": 1, "name": "104+ Octane Boost" }, { "id": 4, "name": "3.1 Phillip Lim" } ], "sizes": [ { "id": 1, "name": "XXS (00)", "short_name": "XXS", "code": "(00)" }, { "id": 2, "name": "XS (0-2)", "short_name": "XS", "code": "(0-2)" } ] } } ```
MCPツール mercari_master
関連API
Marketplaces & Retail
Separate an auction that is still open from a completed sale, and use BaT's own make and model directory to carry valid IDs into search and price-history requests.
Marketplaces & Retail
Treat Glovo as a local marketplace: discover the supported city first, then follow that city's category, store, menu, and collection identifiers through the catalog.
Marketplaces & Retail
Use PetSmart's hierarchical paths to scope product searches, then keep product SKU, price range, online availability, pickup eligibility, and store inventory as separate fields.
Mercariのスクレイピング方法
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.
エージェントスキル
Crawlora のエージェントスキルをインストールすると、スクレイパーを書かずに、ドキュメント化された API 経由で Mercari のデータを JSON として取得できます。Mercari に対応するスキル:
Researches secondhand, resale, handmade, and musical-instrument marketplaces via the Crawlora API. Use to compare live listings and sellers, check…
npx skills add github.com/Crawlora-org/crawlora-skills --skill resale-secondhand-researchFAQ
/mercari/master returned 3,233 categories, 28,825 brands, and 384 sizes on 2026-09-18, all in one response.
Search cards carry created_at_unix and updated_at_unix, which are Unix seconds. Compare them with the current time or with each other.
They are integer cents, not dollars. price_cents of 2499 is $24.99, and original_price_cents carries the pre-markdown figure in the same unit — comparing the two is how you detect a price drop. Divide by 100 before displaying or aggregating.
A broad keyword returns a large single page — 100 normalized listing cards on a live check — rather than a small page you have to walk. For most monitoring workloads that means one request per query, with /mercari/autocomplete first if you need to find the phrasing Mercari's own index matches.