---
title: GeoSearchPagination
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/geosearchpagination
---

# GeoSearchPagination

Pagination parameters for geo location search requests and responses.

## Declaration

```data
object GeoSearchPagination
```

## Properties

totalCount: Total number of results matching the search criteria. Present in the response only. Read-only. offset: Zero-based index of the first result to return. Defaults to 0. pageSize: Maximum number of results to return per page. Defaults to 20.

## Discussion

Discussion The GeoSearchPagination object controls and reports offset-based pagination through geo location search results. When used in a GeoSearchPostRequest body, set offset and pageSize to retrieve a specific page of results. The GET endpoint (GET /v1/search/geo (Search Geo Locations)) accepts offset and pageSize as query parameters instead of a request body. In both cases the response pagination object includes totalCount, enabling callers to calculate the total number of pages available. The default pageSize of 20 is sufficient for most targeted lookups. Increase it for searches expected to return many matching locations. To retrieve the next page, increment offset by pageSize. Example {   "totalCount": 87,   "offset": 20,   "pageSize": 20 }

## See Also

- [GeoRequest](apple-ads-platform-api/georequest.md)
- [GeoSearchPostRequest](apple-ads-platform-api/geosearchpostrequest.md)
- [GeoSearchResponse](apple-ads-platform-api/geosearchresponse.md)
- [GeoEligibility](apple-ads-platform-api/geoeligibility.md)
- [GeoBlockedGroup](apple-ads-platform-api/geoblockedgroup.md)
- [SearchEntity](apple-ads-platform-api/searchentity.md)
