Search for Geolocations
Fetches a list of geolocations for targeting.
URL
GET https://api.searchads.apple.com/api/v5/search/geoQuery Parameters
| Name | Type | Description |
|---|---|---|
countrycode Optional | string | The country or region to serve ads in. Campaigns that serve multiple countries or regions can’t use geotargeting. The query uses a |
entity Optional | string | The An A The Search results in the response payload are in the preferred language according to your organization. If you don’t input a query parameter, all applicable values return in the response payload as a default. |
limit Optional | int32 | The limit on the number of geolocations in the response. |
offset Optional | int32 | The offset pagination that limits the number of returned records. The start of each page is offset by the specified number. You can apply |
query Optional | string | The |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | SearchEntityListResponse | If the call succeeds, the API returns the SearchEntity object in the response payload with an HTTP status code of |
| 400 | Bad Request Content-Type: application/json | ApiErrorResponse | An invalid query or missing required parameters. |
| 401 | Unauthorized Content-Type: application/json | ApiErrorResponse | An unauthenticated call fails to get the requested response. |
| 403 | Forbidden Content-Type: application/json | ApiErrorResponse | Insufficient rights to the resource. |
| 404 | Not Found Content-Type: application/json | ApiErrorResponse | The API can’t locate the resource. |
| 429 | Content-Type: application/json | ApiErrorResponse | The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API. |
| 500 | Internal Server Error Content-Type: application/json | ApiErrorResponse | The Apple Ads server is temporarily down or unreachable. The request may be valid, but you need to retry it later. |
Discussion
Use this endpoint to obtain App Store locations you can use to refine your target audience. Specify the criteria for a geolocation search using the geotargeting criteria CountryCriteria, AdminAreaCriteria, and LocalityCriteria, and then apply them to ad groups using Create an Ad Group and Update an Ad Group endpoints.
[Image]