Sign in Get API key
SUUMO API

SUUMO API for Japanese Rent and Sale Listings, Station Search and Property Details

Scrappa's SUUMO API returns structured JSON from SUUMO, the Japanese real estate portal. Search rental rooms and properties for sale (used and new mansions, new and used houses) by prefecture, city, line and station with rent, price, layout, area, walk time and building age filters. Japanese text stays as published, next to parsed numeric fields such as rent_yen, area_m2 and walk_min.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
6
Endpoints
47
Prefectures
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/suumo/rent/search?prefecture=tokyo&city=13104&rent_max=100000&walk_max=10" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "data": {
    "pagination": {"page": 1, "per_page": 20, "has_next_page": true, "buildings_on_page": 20},
    "listings": [
      {
        "id": "000108054369",
        "building_name": "ハイム荒川",
        "address": "東京都新宿区新宿7",
        "stations": [{"line": "都営大江戸線", "station": "若松河田駅", "walk_min": 7}],
        "layout": "ワンルーム",
        "area_m2": 35.7,
        "rent_text": "8万円",
        "rent_yen": 80000,
        "source_url": "https://suumo.jp/chintai/jnc_000108054369/"
      }
    ]
  },
  "meta": {"endpoint_family": "rent_search", "billable": true}
}

What you can build

Structured data for real applications. Here are some ideas.

Japan Rent Monitoring

Track rent, management fee, deposit and key money per ward or station and watch new rooms appear.

Relocation Tools

Find rooms near a station by walk time, layout, area and building age for expats and movers.

Property Investment Screening

Compare used mansions and houses by price, area, building age, management fee and repair reserve.

New Build Tracking

Follow new mansion projects with price range, layouts, area range and handover date.

Agency Research

Read the agency, licence number and business hours on every rental listing.

SUUMO scraper API

SUUMO API for Japanese rent, sale prices and station search

The SUUMO API is built for Japanese property analytics, relocation and investment tools. Each rent result carries the room id, building, address, every station with walk minutes, rent, management fee, deposit and key money in yen, layout and area. Sale results add price, land and building area and build date. Japanese text is returned unchanged.

Search rent by prefecture, city or station with rent, layout, area, walk time and building age filters.

Search used mansions, new mansions, new houses and used houses for sale.

Every returned listing satisfies every filter you send. A page past the end is empty.

Look up city, town, line and station codes and reuse them in the search.

Failed requests are not charged.

Choose the right SUUMO API endpoint

Use Areas and Lines to find codes

List the cities of a prefecture or the stations of a line and reuse the codes in the rent and sale search.

Open SUUMO Areas API docs

Use Rent Search for market coverage

Search rooms with rent, layout, area and walk time filters and page through the results.

Open SUUMO Rent Search API docs

Use Rent Listing for full records

Open a room by id to get every fee, all stations, photos and the agency.

Open SUUMO Rent Listing API docs

Available endpoints

Everything you need in one API.

GET

Rent Search

/api/suumo/rent/search

Search rental rooms by prefecture, city or station with rent, layout, area, walk time and age filters

Try in Playground View docs
GET

Sale Search

/api/suumo/sale/search

Search used and new mansions and houses for sale with price, area, layout and age filters

Try in Playground View docs
GET

Sale Listing

/api/suumo/sale/listing

Get the price, fees, areas, stations, photos and sales company of one sale listing

Try in Playground View docs

Related resources

Casa Sapo API overview

Add Portuguese property listings to compare real estate markets.

Hemnet API overview

Extend your property data to Sweden with the Hemnet API.

Scrappa vs SUUMO website

See how Scrappa compares to the official API.

Structured JSON
Scrappa:
SUUMO website: HTML pages only
Official public API
Scrappa: API key only
SUUMO website: None
Rent in yen as a number
Scrappa:
SUUMO website: Text such as 8.3万円
Price per 1k requests
Scrappa: From $0.20
SUUMO website: Not available
Unified API key
Scrappa: Yes (80+ APIs)
SUUMO website: Not available
Free tier
Scrappa: 500 credits/month
SUUMO website: Not available

Key features

Rent and sale search by prefecture, city, line and station
Filters for rent, price, layout, area, walk time and building age
Japanese text as published, plus parsed numbers in yen, square meters and minutes
Full listing details with fees, photos and agency
City, town, line and station code lookups
Failed requests are not charged
Simple API key auth with 500 free credits per month

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by SUUMO.

No. Telephone numbers are removed from every response.

No. Japanese text is returned as SUUMO publishes it. Numbers are parsed into extra fields such as rent_yen and area_m2.

Send the page parameter. Every response carries a has_next_page flag. A page past the end returns an empty list with the page you asked for.

Every Scrappa account includes 500 free credits each month. After that, each request costs a fraction of a cent, and failed requests are never charged.

Start using the SUUMO API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation