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

# GeoSearchPostRequest

Request body for querying geo locations.

## Declaration

```data
object GeoSearchPostRequest
```

## Properties

geoRequest: Array of GeoRequest objects. Each entry specifies a geo entity to look up. Supports (entity ID, type) or (legacyID, type) pairs. Supply exactly one of id (numeric) or legacyId (pipe-delimited) per entry along with the required entity type. supplySource: Supply source context for eligibility scoping. Case-insensitive. Values: APPSTORE, MAPS. pagination: Optional pagination parameters controlling page size and offset. See GeoSearchPagination. Defaults to offset: 0, pageSize: 20 if omitted.

## Discussion

Discussion The GeoSearchPostRequest object is the request body for the POST /v1/search/geo (Query Geo Locations) endpoint. It accepts an array of GeoRequest objects, each specifying a geo entity, and returns eligibility data for all of them in a single call scoped to the specified supplySource. Use this for batch-validating a list of location IDs before setting them as ad group targeting values. Each GeoRequest must supply exactly one of id (numeric geo_location_id) or legacyId (pipe-delimited string such as US|CA|San Francisco) plus the required entity field. The response is a GeoSearchResponse containing a result array of matching entities. Available results and entity restrictions differ by supplySource, as shown below:  |   |   |  Example {   "geoRequest": [     {       "id": "123456789",       "entity": "AdminArea"     },     {       "legacyId": "US|CA|San Francisco",       "entity": "Locality"     }   ],   "supplySource": "APPSTORE",   "pagination": {     "offset": 0,     "pageSize": 20   } }

## Topics

### Type Aliases

- [GeoSearchPostRequest.SupplySource](apple-ads-platform-api/geosearchpostrequest/supplysource-data.typealias.md)

## See Also

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