LifestyleBrowser

HOMES JP

homes.co.jp

HOMES JP 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 HOMES' public property search and detail pages rather than a stable API. The scraper must deal with pagination, area and station filters, and partially rendered listing pages while extracting rental and sale property fields.

Expected operations

search-rental-listingsSearch rental listingsreadDifficulty: hard

Search HOMES rental listings by area, station, rent range, and layout. The operation should return the cards shown in the search results and keep the visible pricing and access metadata intact.

Inputs

areastringrequired

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.

Target ward, city, or neighborhood

stationstringoptional

Nearest station used to narrow the listing set

新宿

rent_minnumberoptional

Minimum monthly rent in yen

70000

rent_maxnumberoptional

Maximum monthly rent in yen

180000

floor_planstringoptional

Desired floor plan

2LDK

walk_minutesnumberoptional

Maximum walk time from the station

Outputs

listing_idrentmanagement_feefloor_planareawalk_minutesbuilding_age

Acceptance

Returns HOMES rental cards that match the requested area and filters.
Includes the visible rent, management fee, layout, access time, and building age fields.
Crawls all result pages without duplicating the same property card.

No account auth required for this operation.

get-listing-detailGet listing detailreadDifficulty: hard

Open a HOMES property detail page and extract the complete record, including rent, layout, access, and property age. The implementation should handle pages that reveal extra fields only after client-side rendering.

Inputs

listing_idstringrequired
HOMES listing identifier from the detail page or URL
1234567890

Outputs

listing_idrentmanagement_feefloor_planareawalk_minutes

search-sale-listingsSearch sale listingsreadDifficulty: hard

Search HOMES sale listings using area, price, and property type filters. The implementation must follow paginated result pages and capture the listing cards that appear in the ownership and resale indexes.

Inputs

areastringrequired
Target municipality or ward for the sale search
横浜市西区
price_maxnumberoptional
Maximum purchase price in yen
60000000
property_typestringoptional
Sale property type such as house or apartment
house
walk_minutesnumberoptional
Maximum walk time from the station
12

Outputs

listing_idrentmanagement_feefloor_planareawalk_minutes

Acceptance

Returns the requested listing_id when the detail page is accessible.
Uses the detail-page values for management_fee, area, and building_age rather than approximating them from search cards.
Reports a blocked or missing result when the page is unavailable instead of inventing fallback content.

No account auth required for this operation.

Acceptance

Returns only sale listings that match the requested area and property type.
Preserves the listing_id and visible metadata for comparing results across pages.
Handles pagination without repeating the same listing across result pages.

No account auth required for this operation.