Next page of a search
GET
https://platform.casafari.com/v1/property-sourcing/searches/{cursor}API key100 units per page1 parameter
Send Authorization: Bearer $CASAFARI_API_KEY: a platform API key or OAuth access token; see platform sign-in. Costs 100 units per page (1 unit = EUR 0.04).
Over MCP: none; this product is REST only.
Description
The next page of a search: follow the next URL a search returned. A cursor carries its search, is bound to the account that ran it and is valid for one hour; nothing is stored. A forged, altered, expired or another account's cursor is 404 not_found. One search reaches at most 1,000 results (100 on Free). 100 units per page.
Path parameters
cursorstringrequiredThe
cur_... cursor at the end of a next URL.Example request
Placeholders only: replace the token and the values with your own.
curl "https://platform.casafari.com/v1/property-sourcing/searches/cur_SAMPLE" \
-H "Authorization: Bearer $CASAFARI_API_KEY"Responses
200 The next page of properties.
Type: object.
Show the response shape (21 fields)
resultsobject[]10 properties
idstringOpaque property id,
prop_....typestringnullableProperty type.
operationstringsale rentpriceobject3 properties
amountnumbernullableAsking price; null when the price is on request.
currencystringnullableISO 4217 currency code.
per_sqmnumbernullableAsking price per m².
bedroomsnumbernullableliving_area_sqmnumbernullablelocationobject3 properties
idintegernullableLocation id.
namestringnullableLocation name.
coordinatesobjectnullableLatitude and longitude.
2 properties
latnumberlonnumberfirst_seenstringnullableWhen the property came on the market for this operation.
listings_countintegernullableHow many listings advertise it; known on a property read with expand=listings, null in search results.
matched_tagsstring[]nullableThe phrases of a plain-language search this property matched; null for structured searches.
totalintegernullableHow many properties match, when known.
nextstringnullableURL of the next page (valid one hour), or null.
Example with sample values (ids and figures are illustrative)
{
"results": [],
"total": 312,
"next": null
}400 The search already reached its depth limit (`page_depth_exceeded`).
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring401 Missing or unknown API key or token.
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring402 No units left to fund the call (`payment_required`).
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring404 Unknown, altered, expired or another account's cursor (`not_found`). Run the search again.
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring429 A request limit of the plan was reached (`request_limit_reached`).
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring