LifestyleBrowser

Property Finder

propertyfinder.ae

UAE property discovery and shortlist workflows for Property Finder.

Tier: 🥈 Silver
Reward: ₩150,000
Auth: Browser
Operations: 5
Working now: 0 contributors
Status: Open

Scope

Build a browser-facing UAE real estate provider for Property Finder. The surface is an unofficial web workflow, so it must handle search filters, listing detail pages, saved comparisons, alerts, and inquiry preparation without implying a public API or auto-contacting agents.

Expected operations

search-listingsSearch listingsreadDifficulty: medium

GET property search results filtered by emirate, community, price range, bedrooms, property type, and furnishing status. Returns normalized listing cards suitable for comparison and shortlisting.

Inputs

emiratestringoptional

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.

Emirate name to constrain results, such as Dubai or Abu Dhabi.

communitystringoptional

Community or neighborhood name to narrow the search.

Dubai Marina

price_minnumberoptional

Minimum asking price or annual rent.

120000

price_maxnumberoptional

Maximum asking price or annual rent.

250000

bedsnumberoptional

Minimum or exact bedroom count depending on the site filter behavior.

property_typestringoptional

Type of property such as apartment, villa, townhouse, or office.

apartment

purposestringoptional

Search purpose such as rent or buy.

rent

pagenumberoptional

Result page number for pagination.

Outputs

total_countresultstitlepricebedroomsbathroomscommunityproperty_typelisting_url

Acceptance

Returns a paginated result set with total_count and listing cards for the requested filters.
Preserves key listing fields such as price, bedrooms, community, and listing_url for each result.
Handles empty-result searches cleanly when the filter combination has no matches.

No account auth required for this operation.

get-listing-detailGet listing detailreadDifficulty: medium

Open a listing detail page and extract pricing, fees, amenities, floor plan indicators, and the agent or broker profile shown on the page.

Inputs

listing_urlstringrequired
Canonical listing page URL or listing identifier resolved from search results.
https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-marina-123456.html

Outputs

titlepricefeesamenitiesfloor_planagent_name

compare-saved-listingsCompare saved listingsreadDifficulty: medium

Compare a user-maintained shortlist of saved listings and highlight price, status, and availability changes since the last check.

Inputs

saved_listing_idsarrayrequired
List of saved listing identifiers or URLs to compare.
["123456","789012"]
compare_againststringoptional
Optional baseline such as previous snapshot or last_checked.
last_checked

Outputs

changesstatuspriceavailabilitylast_seenlisting_url

prepare-inquiryPrepare inquirywriteDifficulty: hard

Assemble the fields needed for a viewing or agent inquiry, but stop before sending anything unless the user explicitly confirms the action.

Inputs

listing_urlstringrequired
Listing page that the user wants to inquire about.
https://www.propertyfinder.ae/en/plp/rent/apartment-for-rent-dubai-marina-123456.html
contact_namestringrequired
Name to place on the inquiry form.
Aisha Khan
contact_emailstringrequired
Email address used for the agent inquiry.
aisha@example.com
contact_phonestringoptional
Phone number if the form requires a callback.
+971501234567
messagestringoptional
Optional message describing the viewing request or questions.
Please share availability for a weekend viewing.

Outputs

draft_statuslisting_urlcontact_namecontact_emailcontact_phonemessage

list-saved-searches-and-alertsList saved searches and alertsreadDifficulty: medium

Retrieve saved search filters, alert settings, contacted agents, and listing status information for the current user session.

Inputs

include_agentsbooleanoptional
Whether to include contacted agent history in the response.
true
include_statusesbooleanoptional
Whether to include current listing status values such as available or rented.
true

Outputs

saved_searchesalertscontacted_agentslisting_statusescreated_at

Acceptance

Returns the user's saved-search and alert configuration rather than only search results.

Acceptance

Returns listing-level details rather than only the search-card summary.
Includes any visible fees, amenity markers, and agent or broker identity fields shown on the page.
Does not fabricate floor plan or contact data when the page omits it.

No account auth required for this operation.

Acceptance

Returns a per-listing comparison result instead of a flattened summary only.
Flags price or availability changes when a saved listing has moved or been updated.
Keeps the output stable enough to support alerting or shortlist review.

Auth required for this operation.

Acceptance

Prepares a complete inquiry draft without submitting it automatically.
Requires an explicit confirmation state before any contact action is attempted.
Echoes the destination listing and contact fields so the user can review them before sending.

Auth required for this operation.

Includes contacted agent history only when requested and available to the session.

Uses current listing status values that reflect the site state at retrieval time.

Auth required for this operation.