{"openapi":"3.1.0","info":{"title":"Japan Property Research developer API","version":"1.0.0","description":"Research tools for Japanese property: lot numbers (地番), land prices, past transactions, zoning, school districts and market listings. Also available over MCP at https://japanpropertyresearch.com/mcp, which is the transport most callers use."},"servers":[{"url":"https://japanpropertyresearch.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"A developer API key (jpnr_...), created in the dashboard at /developer."}},"schemas":{"ToolCall":{"type":"object","required":["name"],"properties":{"name":{"type":"string","enum":["lookup_lot_number","get_lot_number_address","get_city_price_stats","get_land_price_evidence","get_zoning_summary","get_designated_schools","get_listings_nearby","get_listing_detail","get_past_transactions","generate_market_insight_brief"]},"input":{"type":"object","additionalProperties":true}}}}},"paths":{"/api/research/tools":{"get":{"summary":"List the tools available on your plan","security":[],"responses":{"200":{"description":"The tool catalogue","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"tools":{"type":"array","items":{"type":"object"}}}}}}}}},"post":{"summary":"Run one or more tools","description":"Send `tool` + `input` for a single call, or `tools[]` for a batch. A batch spends one unit of quota per tool and every tool in it must be on your plan.","requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["tool"],"properties":{"tool":{"type":"string","enum":["lookup_lot_number","get_lot_number_address","get_city_price_stats","get_land_price_evidence","get_zoning_summary","get_designated_schools","get_listings_nearby","get_listing_detail","get_past_transactions","generate_market_insight_brief"]},"input":{"type":"object","additionalProperties":true}}},{"type":"object","required":["tools"],"properties":{"tools":{"type":"array","items":{"$ref":"#/components/schemas/ToolCall"}}}}]}}}},"responses":{"200":{"description":"Every tool call succeeded"},"207":{"description":"Some tool calls failed; see `results[].ok`"},"401":{"description":"Missing or invalid API key"},"403":{"description":"The tool is not on your plan (`tool_not_on_plan`), or the plan has no API access (`plan_required`). Upgrading is the fix; retrying is not."},"429":{"description":"Over the per-minute rate (`rate_limited`), the monthly call quota (`quota_exceeded`), or the monthly listing-row budget (`row_budget_exceeded`). See `Retry-After`."}}}}},"x-tools":[{"name":"lookup_lot_number","description":"Resolve a Japanese address into its lot number (地番) and parcel geometry.","free":true,"inputSchema":{"type":"object","properties":{"address":{"type":"string","description":"Japanese or romaji address."}},"required":["address"]}},{"name":"get_lot_number_address","description":"Resolve a lot number (地番) back into its residential address.","free":true,"inputSchema":{"type":"object","properties":{"lotNumber":{"type":"string","description":"Lot number with its municipality, e.g. 倶知安町字山田123番1."}},"required":["lotNumber"]}},{"name":"get_city_price_stats","description":"Municipality-level land price statistics across Japan, optionally filtered by city or prefecture.","free":true,"inputSchema":{"type":"object","properties":{"cityCode":{"type":"string","description":"Optional 5-digit city code."},"prefecture":{"type":"string","description":"Optional prefecture name."}}}},{"name":"get_land_price_evidence","description":"Return land-price points with explicit price per sqm and YoY summary.","free":false,"inputSchema":{"type":"object","properties":{"address":{"type":"string","description":"Japanese address; resolved to lat/lng when omitted."},"lat":{"type":"number"},"lng":{"type":"number"},"radiusKm":{"type":"number","default":0.5}}}},{"name":"get_zoning_summary","description":"Return zoning polygon totals and top zoning classes by count.","free":false,"inputSchema":{"type":"object","properties":{"address":{"type":"string","description":"Japanese address; resolved to lat/lng when omitted."},"lat":{"type":"number"},"lng":{"type":"number"},"radiusKm":{"type":"number","default":0.5}}}},{"name":"get_designated_schools","description":"Return designated elementary/junior high school assignments for a point.","free":false,"inputSchema":{"type":"object","properties":{"address":{"type":"string","description":"Japanese address; resolved to lat/lng when omitted."},"lat":{"type":"number"},"lng":{"type":"number"},"radiusKm":{"type":"number","default":0.5}}}},{"name":"get_listings_nearby","description":"Fetch active property listings near a point with price and type summaries.","free":true,"inputSchema":{"type":"object","properties":{"address":{"type":"string","description":"Japanese address; resolved to lat/lng when omitted."},"lat":{"type":"number"},"lng":{"type":"number"},"radiusKm":{"type":"number","default":1.2},"bbox":{"type":"string","description":"west,south,east,north (optional; overrides radiusKm)"},"cityCode":{"type":"string","description":"Optional 5-digit city code for administrative boundary filtering."},"limit":{"type":"number","default":60},"offset":{"type":"number","default":0},"sortBy":{"type":"string","default":"price_asc"},"currency":{"type":"string","default":"JPY"},"minPrice":{"type":"number"},"maxPrice":{"type":"number"},"minYearBuilt":{"type":"number"},"maxYearBuilt":{"type":"number"},"listingType":{"type":"string","description":"Comma-separated listing types"}}}},{"name":"get_listing_detail","description":"Fetch detailed listing data for a specific listingId.","free":false,"inputSchema":{"type":"object","properties":{"listingId":{"type":"string"}},"required":["listingId"]}},{"name":"get_past_transactions","description":"Fetch MLIT-style past transaction records and summary statistics.","free":false,"inputSchema":{"type":"object","properties":{"address":{"type":"string","description":"Japanese address; resolved to lat/lng when omitted."},"lat":{"type":"number"},"lng":{"type":"number"},"radiusKm":{"type":"number","default":2.5},"prefecture":{"type":"string"},"cityCode":{"type":"string"},"cityCodes":{"oneOf":[{"type":"string","description":"Comma-separated city codes"},{"type":"array","items":{"type":"string"}}]},"stationName":{"type":"string"},"propertyTypes":{"oneOf":[{"type":"string","description":"Comma-separated property types"},{"type":"array","items":{"type":"string"}}]},"periodFrom":{"type":"string","description":"e.g. 2023年第1四半期"},"periodTo":{"type":"string","description":"e.g. 2024年第4四半期"},"limit":{"type":"number","default":200}}}},{"name":"generate_market_insight_brief","description":"Generate a professional, quotable market insight brief from nearby land-price and transaction evidence.","free":false,"inputSchema":{"type":"object","properties":{"address":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"},"country":{"type":"string","default":"JP"},"cityCode":{"type":"string"},"cityCodes":{"oneOf":[{"type":"string","description":"Comma-separated city codes"},{"type":"array","items":{"type":"string"}}]},"radiusKm":{"type":"number","default":1.2},"townCoverageRadiusKm":{"type":"number","default":6,"description":"Town-level coverage radius (km) for transport/amenities/zoning/climate and default land evidence scope."},"landEvidenceRadiusKm":{"type":"number","description":"Land-price evidence search radius (km). Defaults to townCoverageRadiusKm."},"transactionsRadiusKm":{"type":"number","default":2.5},"transactionsLimit":{"type":"number","default":180},"reportYear":{"type":"number","default":2025},"transactionsPeriodFrom":{"type":"string","description":"e.g. 2025年第1四半期"},"transactionsPeriodTo":{"type":"string","description":"e.g. 2025年第4四半期"}}}}]}