LifestyleBrowser

SUUMO

suumo.jp

SUUMO real-estate provider for the unofficial listing surface.

Tier: 🥇 Gold
Reward: ₩300,000
Auth: Browser
Operations: 3
Working now: 0 contributors
Status: Open

Scope

Targets SUUMO's public rental and sales listing pages, not a documented API. The implementation must handle station and area filters, pagination, and anti-bot controls while extracting listing and detail data for apartments and houses.

Expected operations

search-rental-listingsSearch rental listingsreadDifficulty: hard

Search SUUMO rental results with location and property filters such as station, rent range, layout, floor area, and walking time. The operation should follow the listing pages and return the cards shown in the search grid.

Inputs

prefecturestringoptional

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

Prefecture name or code used as the top-level area filter

stationstringoptional

Nearest station name used in commute-based search

渋谷

rent_minnumberoptional

Minimum monthly rent in yen

80000

rent_maxnumberoptional

Maximum monthly rent in yen

150000

floor_planstringoptional

Desired layout such as 1LDK or 2DK

1LDK

walk_minutesnumberoptional

Maximum walk time from the station in minutes

Outputs

listing_idrentmanagement_feefloor_planareawalk_minutesbuilding_age

Acceptance

Returns only listings matching the requested area and price constraints.
Includes rent, management_fee, floor_plan, area, walk_minutes, and building_age for each card.
Supports paginated search results and does not duplicate listings across pages.

No account auth required for this operation.

get-listing-detailGet listing detailreadDifficulty: hard

Open a SUUMO listing page and extract the full property record, including rent, layout, floor area, access, and age. The scraper should gracefully handle hidden fields and pages that load partial data after the initial HTML response.

Inputs

listing_idstringrequired
SUUMO listing identifier from the detail URL or page metadata
100123456789

Outputs

listing_idrentmanagement_feefloor_planareawalk_minutes

search-sale-listingsSearch sale listingsreadDifficulty: hard

Search SUUMO sale and ownership listings using area, price, and property-type filters. The operation must navigate paginated result pages and return cards for houses and condominiums shown in the sale index.

Inputs

areastringrequired
Target city, ward, or municipality for the sale search
世田谷区
price_maxnumberoptional
Maximum purchase price in yen
80000000
property_typestringoptional
Property type such as house or condominium
condominium
walk_minutesnumberoptional
Maximum walking time from the station for filtered results
10

Outputs

listing_idrentmanagement_feefloor_planareawalk_minutes

Acceptance

Returns the requested listing detail with the same listing_id that was supplied.
Preserves detail-page values such as management_fee, area, and building_age rather than using search-card approximations.
Reports a clear not-found or blocked result when the listing is removed or access is throttled.

No account auth required for this operation.

Acceptance

Returns sale listings for the requested area and property type.
Carries listing_id and the visible metadata needed to compare properties across pages.
Handles multiple result pages without repeating the same property card.

No account auth required for this operation.