---
title: Query Geo Locations
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/gets-a-list-of-geo-locations
---

# Query Geo Locations

Search for geographic locations by entity type and ID for use in ad group geo targeting.

## URL

POST https://api.ads.apple.com/v1/search/geo

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

Discussion This endpoint returns a list of geographic locations matching the specified entity criteria. To look up valid geo IDs and names before assigning geo targets to an ad group, use this endpoint. The API sorts results alphabetically by displayName and paginates them using GeoSearchPagination. Each result is a SearchEntity and includes a hierarchy identifier in legacyId, which is a pipe-delimited string that encodes the full geographic hierarchy, such as US|CA|San Francisco. See GeoEntityType for the full list of entity granularities. The supplySource field controls which entity types appear in the response. Use APPSTORE for App Store campaigns and MAPS for Apple Maps campaigns. Unlike the GET endpoint, the POST endpoint doesn’t filter by eligibility. The API always returns soft-blocked geos with their eligibility data included. Payload Examples

## See Also

- [Search Geo Locations](apple-ads-platform-api/searches-for-a-list-of-geo-locations.md)