Statistics

Ta strona nie została jeszcze przetłumaczona na Twój język. Wyświetlamy wersję angielski (Wielka Brytania).

Two read-only counts: how many of your listings are in each status, and how listings spread across places and types, for location menus, filter dropdowns and place pickers. Both need the properties:read scope.

Count your listings per status

`GET /properties/stats/counts`

bash

curl https://api.fondaro.com/properties/stats/counts \  -H "Authorization: Bearer fondaro_pk_abc123"

json

{  "active": 48,  "inactive": 12,  "pending": 5,  "sold": 23,  "rented": 8}

Every status is present, with 0 when you have none. Deleted listings are not counted.

Count listings by place and type

`GET /properties/stats/aggregations`

Counts every agency's active listings by default. Asking for your own listings, or for any status other than active, counts only your agency's.

Query	Type	Meaning
`status`	string	Default `active`; any other status counts your own listings only
`filterByOrganization`	boolean	Count only your own listings
`countryCode`, `region`, `city`	string, repeatable	Narrow the counts (`countryCode=ES&countryCode=PT`)
`q`	string	Place-picker text: narrows towns and regions to names containing it (accents and case ignored) and adds matching `communities`

bash

curl "https://api.fondaro.com/properties/stats/aggregations?countryCode=ES" \  -H "Authorization: Bearer fondaro_pk_abc123"

json

{  "byCity": {    "Marbella": { "total": 45, "byType": { "house_detached": 12, "apartment": 28, "penthouse": 5 } },    "Calpe": { "total": 18, "byType": { "apartment": 14, "townhouse": 4 } }  },  "byRegion": {    "Costa del Sol": { "total": 45, "byType": { "house_detached": 12, "apartment": 28, "penthouse": 5 } }  },  "byCountry": {    "ES": { "total": 63, "byType": { "house_detached": 12, "apartment": 42, "penthouse": 5, "townhouse": 4 } }  },  "byPropertyType": { "house_detached": 12, "apartment": 42, "penthouse": 5, "townhouse": 4 },  "byPropertyCategory": { "residential": 63 },  "availableCities": ["Marbella", "Calpe"],  "availableRegions": ["Costa del Sol", "Costa Blanca"],  "availableCountries": ["ES"],  "availablePropertyTypes": ["house_detached", "apartment", "penthouse", "townhouse"],  "availablePropertyCategories": ["residential"],  "totalProperties": 63}

Use the names in availableCities and availableRegions as the city and region filters of Search.

Search places

With q, the response also has communities: areas whose name, town or region contains q, most listings first, up to 50. One community name can exist in two towns, so each carries its town.

bash

curl "https://api.fondaro.com/properties/stats/aggregations?q=quinta" \  -H "Authorization: Bearer fondaro_pk_abc123"

json

{  "communities": [    { "name": "La Quinta", "city": "Benahavís", "region": "Málaga", "total": 7 }  ]}

Freshness

Network-wide active counts are cached for 5 minutes, so a listing published a moment ago can take that long to appear. Counts of your own listings are always current.