ジモティー API：地域の出品と中古相場を JSON で
ジモティーに掲載されている広告のうち、ログインせずに見られるものを読み取り、JSON で返します。中古品の「売ります・あげます」のほか、中古車、不動産、正社員とアルバイトの求人、里親募集、教室、イベントなど 11 の掲示板を、都道府県 → 市区町村 → 駅の 3 段階の地域、カテゴリ、円の価格帯で絞り込めます。「ジモティー 冷蔵庫 相場」のように、ある地域で中古品がいくらで出ているかを数字で集めるための API です。出品や問い合わせ、取引の自動化には使えません。読むのは探す側の画面に出ている情報だけで、ジモティーに何かを書き込むことはありません。
エンドポイント
| endpoint | 返ってくるもの | 必須 |
|---|---|---|
| search | 掲示板（`group`）を一つ選び、その中をキーワード、都道府県、カテゴリ、ジャンル ID、市区町村 ID または駅 ID、円の下限・上限、0円の掲載だけ（`free_only`）、オンライン決済に対応した掲載だけ、で絞り込みます。1 ページ 50 件で、ジモティー自身が数えた総件数（`total_results`）が付きます。一覧の上に差し込まれる PR 掲載は `promoted` に分け、提携サイトの求人枠は取り除いて件数だけを返します。 | group |
| listing | 掲載 1 件の全体：本文、すべての写真、掲示板ごとの項目（車なら走行距離・年式、物件なら賃料・間取り・階数、求人なら給与・勤務時間）、座標、お気に入り数と問い合わせ数、業者の掲載かどうか（`is_business_poster`）、投稿者の公開プロフィール。`url` か、`listing_id` と `group`・`category` の組み合わせで指定します。締め切られた掲載や削除された掲載はエラーにならず、`status` で分かります。 | すべて任意 |
| seller | 投稿者の公開プロフィール：本人確認のバッジ、評価（良い・普通・悪い）の件数、登録時期、プロフィールページに並んでいる掲載。ページに出るのは一部だけなので、何件取れたかは `listings_sampled` に入ります。 | seller_id |
| categories | 掲示板ごとのカテゴリ（`fur` = 家具、`ele` = 家電 など）と、その下のジャンル ID。11 の掲示板それぞれが金額を載せるかどうかの一覧も返ります。 | group |
| locations | 47 都道府県のローマ字表記（`tokyo`、`osaka` など）と、その下の市区町村 ID。search の `prefecture` と `city_id` にそのまま使えます。 | すべて任意 |
呼び出しごとにクレジットを消費します。失敗した呼び出しとブロックされた呼び出しは無料です。
動作する例
2026年10月27日、東京都の「売ります・あげます」で冷蔵庫（ジャンル 1103）を検索すると、総件数は 111,804 件でした。1 ページ目の 50 件のうち 9 件が 0円、つまり「あげます」で、残り 41 件の中央値は 24,000 円、いちばん安いものが 100 円、高いものが 69,800 円です。0円の掲載は `price_jpy: 0`、`price_kind: "free"` として返り、null にはなりません。相場を出すときに `price_kind` で分けておかないと、あげますの 0 円が平均を大きく引き下げます。このページには提携サイトの求人枠が 7 件差し込まれていましたが、結果からは外し、`dropped_partner_tiles` に件数だけを残しています。
curl -X POST https://api.reefapi.com/jmty/v1/search \
-H "x-api-key: あなたのキー" \
-H "content-type: application/json" \
-d '{"group": "sale", "prefecture": "tokyo", "category": "ele", "genre_id": 1103}'{
"ok": true,
"data": {
"total_results": 111804,
"page": 1,
"page_size": 50,
"page_ceiling": 1000,
"reachable_rows": 50000,
"promoted_count": 0,
"dropped_partner_tiles": 7,
"has_more": true,
"category_group_name": "中古あげます・譲ります",
"source_url": "https://jmty.jp/tokyo/sale-ele/g-1103",
"listings": [
{
"listing_id": "1sta9m",
"url": "https://jmty.jp/tokyo/sale-ele/article-1sta9m",
"title": "【今日限定】ハイアール冷蔵庫 2023年製BR-85A",
"headline": "0円",
"price_jpy": 0,
"price_kind": "free",
"city_name": "豊島区",
"station_name": "下板橋駅",
"genre_name": "キッチン家電",
"genre_id": 1102,
"created_label": "10月27日",
"favorite_count": 3
},
{
"listing_id": "1stg5h",
"title": "1423【日野市 配送・設置無料】日立 大型冷蔵庫 315L R...",
"headline": "52,000円",
"price_jpy": 52000,
"price_kind": "fixed",
"city_name": "日野市",
"station_name": null,
...
},
...
{
"listing_id": "1sq1r5",
"title": "冷蔵庫",
"headline": "3,000円",
"price_jpy": 3000,
"price_kind": "fixed",
"city_name": "世田谷区",
"station_name": "西太子堂駅",
...
},
...
]
},
"meta": { "record_count": 50, "upstream_requests": 1, "cache_hit": false, "mode": "live" }
}ジモティーを自前でスクレイピングすると数字が狂うところ
一覧の各行には目立つ一行が表示されますが、その意味は掲示板ごとに違います。「売ります・あげます」では品物の価格、不動産では「2.2万円」のような万単位の月額賃料、正社員の求人では年収や月収、アルバイトでは日給や時給です。教室では市区町村名、里親募集では「オス 0才2ヶ月」のような性別と年齢で、そもそも金額ではありません。この行から数字だけを拾うと、7.5万円の家賃が 7.5 になり、里親募集のペットの年齢が値段になります。この API では原文を `headline` に残し、金額を載せる 6 つの掲示板でだけ `price_jpy` と `price_basis`（月額賃料・時給・年収など）を返します。
中古品の検索にも、別のサイトの人材派遣の求人がおよそ 8 行に 1 回差し込まれ、「時給1,500円」が価格の位置に入ります。見た目は同じリスト項目なので、そのまま読むとソファの相場に時給が混ざります。こうした枠は結果から外して `dropped_partner_tiles` で数えています。
0円は欠けた値ではありません。2026年10月2日の測定で、「売ります・あげます」の全国 32,059,946 件は、0円の 6,909,490 件と 1円以上の 25,150,456 件の合計とぴったり一致しました。それなのに Python で `if not price:` と書くと 0 は空と同じ扱いになり、あげます掲載がまとめて価格なしに変わります。
詳細ページも 1 種類ではありません。11 の掲示板のうち 5 つは新しい形式、6 つは古い形式のページで、私たちの最初のパーサーは新しい形式しか読めず、古い 6 つの掲示板で中身が空の詳細を `ok: true` のまま返していました。いまはページの中身を見て形式を判断しています。近所の冷蔵庫の値段を一度見るだけならジモティーのアプリで十分です。地域別の相場を毎週記録する場合は、エラーを出さずに数字だけがずれるこの種の読み違いを、記録を始める前に潰しておく必要があります。
制限と正直な注記
- 株式会社ジモティーが提供している API ではありません。同社との契約や提携もありません。
- ジモティーの一覧は 1,000 ページ目で終わり（サイトでは 1,001 ページ目が 404、この API では `page` が 1,000 を超えると INVALID_PARAM）、同じ条件で見られるのは 50,000 件までです。`total_results` がそれを超えるときは、市区町村、ジャンル、価格帯などで条件を細かくしてください。
- 並び替えはできません。ジモティーの一覧に並び替えの機能がなく、順番はサイトのままです。続けて取得すると、更新された掲載が上がってくるため、隣り合うページで 50 件中 1 件ほど重なることがあります。
- categories が返すジャンルは「キッチン家電」（1102）の階層までです。冷蔵庫（1103）のような一段下の分類は一覧に出ませんが、search の `genre_id` には使えます。今回は 1102 で 269,728 件、1103 で 111,804 件でした。検索結果の行の `genre_id` は 1102 のままで、1103 は listing で分かります。
- 業者の掲載か個人の掲載かは listing の `is_business_poster` にしか出ません。東京の冷蔵庫の 1 ページ目にも「配送・設置無料」をうたう業者の掲載が多く並んでいたので、個人間の相場を見たいときは listing で確かめてください。
- listing と seller は投稿者のニックネームなど公開プロフィールを含み、掲載に電話番号が書かれていればそれも返ります。上の例では省いています。相場の集計に投稿者の情報は必要ありません。
- 料金：search は 1 回 3 クレジット、listing・seller・categories・locations は 1 回 2 クレジットです。
- キャッシュはなく、呼び出したその時点の掲載を返します。