Query Supported App Languages
Query countries and regions to discover the ad-supported languages available in each market.
URL
POST https://api.ads.apple.com/v1/metadata/apps/supported-languages/queryHeader Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | AppSupportedLanguagesQueryResponse | |
| 400 | Bad Request Content-Type: application/json | AppSupportedLanguagesQueryResponse | |
| 401 | Unauthorized Content-Type: application/json | Error | |
| 403 | Forbidden Content-Type: application/json | Error | |
| 404 | Not Found Content-Type: application/json | Error | |
| 429 | Too Many Requests Content-Type: application/json | Error | |
| 500 | Internal Server Error Content-Type: application/json | Error |
Discussion
This endpoint returns a list of countries and regions along with the languages supported for Apple Ads in each market, including each market’s adsSupportedLanguages and adsDefaultLanguages.
Use this endpoint to:
Validate locale codes before setting them on creatives or ad groups.
Populate country/language selection UI in campaign setup workflows.
Confirm which languages are available when expanding campaigns into new markets.
An empty request body returns all supported countries and regions with default pagination. To scope results to specific country codes, use filters. To order results alphabetically, use sorting.
See QueryFilterOperator for the full set of supported comparison operators.
Filterable Fields
Field | Type | Operators | Sortable | Description |
|---|---|---|---|---|
| string |
| Yes | ISO 3166-1 alpha-2 country code (for example, |
| string |
| Yes | Full country or region name |
The request body is a QueryRequest composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination.
Each result row includes the following fields:
Field | Type | Description |
|---|---|---|
| string | Full display name of the country or region (for example, |
| string | ISO 3166-1 alpha-2 code (for example, |
| array | All language/locale combinations eligible for Apple Ads creatives and targeting in this market |
| array | The default language(s) used when no explicit locale is specified |
| string | Language identifier (for example, |
| string | Full locale code (for example, |