Skip to main content

Overview

Search endpoints return paginated results. The SDK provides PaginatedResult<T> which implements AsyncIterable, letting you iterate through all items across all pages without manual page management.

Basic usage

The iterator automatically fetches the next page when the current page is exhausted.

Collecting results

Use toArray() to collect all items into an array:

Accessing page metadata

The initial response includes pagination metadata:

Controlling page size

Example: export all Brooklyn rentals

Rate limit awareness

Auto-pagination respects your tier’s rate limits. If you hit a rate limit during pagination, the SDK automatically retries with backoff. For large exports, consider using a larger perPage value to reduce the number of requests.