---
title: "Next page of a search"
method: GET
path: "/v1/property-sourcing/searches/{cursor}"
tags: ["platform---property-sourcing"]
---

# Next page of a search

`GET /v1/property-sourcing/searches/{cursor}`

## Request

- Base URL: `https://platform.casafari.com`
- URL: `https://platform.casafari.com/v1/property-sourcing/searches/{cursor}`
- Auth: HTTP bearer

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 tokens per page.

## Path parameters

- `cursor` string, required

## Response `200`

The next page of properties.

- PropertySourcingSearchPage
  - `results` PropertySourcingResult[]
    - `id` string: Opaque property id, `prop_...`.
    - `type` string, nullable: Property type.
    - `operation` 'sale' | 'rent'
    - `price` PlatformPrice
      - `amount` number, nullable: Asking price; null when the price is on request.
      - `currency` string, nullable: ISO 4217 currency code.
      - `per_sqm` number, nullable: Asking price per m².
    - `bedrooms` number, nullable
    - `living_area_sqm` number, nullable
    - `location` PlatformLocation
      - `id` integer, nullable: Location id.
      - `name` string, nullable: Location name.
      - `coordinates` object, nullable: Latitude and longitude.
        - `lat` number
        - `lon` number
    - `first_seen` string, nullable: When the property came on the market for this operation.
    - `listings_count` integer, nullable: How many listings advertise it; known on a property read with expand=listings, null in search results.
    - `matched_tags` string[], nullable: The phrases of a plain-language search this property matched; null for structured searches.
  - `total` integer, nullable: How many properties match, when known.
  - `next` string, nullable: URL of the next page (valid one hour), or null.

## Other responses

- `400`: The search already reached its depth limit (`page_depth_exceeded`).
- `401`: Missing or unknown API key or token.
- `402`: No tokens left to fund the call (`payment_required`).
- `404`: Unknown, altered, expired or another account's cursor (`not_found`). Run the search again.
- `429`: A request limit of the plan was reached (`request_limit_reached`).

---

[API](https://skmtc.dev/casafari/apis/casafari-api.md) · [All operations](https://skmtc.dev/casafari/apis/casafari-api/llms.txt) · [OpenAPI document](https://skmtc.dev/casafari/apis/casafari-api/revisions/6743b99d4bf9?raw)