Property Finder agency profile

GET https://api.api.sh/propertyfinder/v1/agency
1 credit / call real estate try it in the playground →

One agency (broker): name, description, address, office phone and email, licence, listing counts, agent counts, logo, its agents (with listing counts) and its listings (25 a page, every page, filterable by category; listings_total, listings_pages, next_page).

Every response includes credits_used: the credits this call cost.

Parameters

nametypedescription
slug string The agency part of its link, e.g. engel-volkers-secondary-sales-2-12798. Example: engel-volkers-secondary-sales-2-12798
url string A propertyfinder.ae/en/broker/<name>-<id> link.
page integer Listings page (25 a page). Pass next_page back; null on the last page. Example: 2 Default: 1
category buy | rent | commercial_buy | commercial_rent Only listings of this category (default: all).
sort featured | newest | price_low | price_high | beds_least | beds_most Listings order (default: the site's own, featured first).

Every endpoint also takes fresh, raw, fields (see lean responses and caching).

Example

curl "https://api.api.sh/propertyfinder/v1/agency?slug=engel-volkers-secondary-sales-2-12798" \
  -H "x-api-key: $APISH_KEY"

Response

A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).

The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.