docs / japan-re

Japan Real Estate

Japan property listings and details.

base /japan-re/v12 endpoints

post/japan-re/v1/listings/search2 credits

SUUMO listings search (prefecture=tokyo|kanagawa|osaka|kyoto)

Parameter		Allowed / range	Description
prefecture = tokyo	optional	tokyo · kanagawa · osaka · kyoto	Prefecture to search (only these 4 are supported).
listing_type = rent	optional	rent · sale_used_house · sale_used_condo	Transaction/property type (rent / used house / used condo).
page = 1	optional	1–	1-based results page.
max_pages = 1	optional	1–	How many pages to fetch and merge from `page` onward (stops early on an empty page).

Try in playground →

post/japan-re/v1/listings/detail2 credits

full listing detail (tables + inline JSON)

Parameter		Allowed / range	Description
listing_id	required	—	SUUMO listing id (the digits in a suumo.jp jnc_<id> URL).

Try in playground →

Example request · listings/search

curl -X POST https://api.reefapi.com/japan-re/v1/listings/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"prefecture":"tokyo","listing_type":"rent","page":1,"max_pages":1}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}