Query Product Page Locale Details

Queries the localized content associated with a custom product page.

URL

POST https://api.ads.apple.com/v1/product-pages/locale-details/query

Header Parameters

Name	Type	Description
`X-Ap-Context` Required	string

Response Codes

Status	Reason	Type
200	OK Content-Type: application/json	`ProductPageLocaleDetailsQueryResponse`
400	Bad Request Content-Type: application/json	`ProductPageLocaleDetailsQueryResponse`
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 queries the localized content associated with a specific product page. For each language version, the response returns the metadata that Apple Ads will show (including the localized appName, subTitle, promotionalText, and shortDescription) along with asset references organized by device class in the assetsByDevice field.

To preview how a product page creative will appear across different locales before using it in a campaign, use this endpoint. This is especially useful when managing multi-locale campaigns to verify that all required language variants are present and correctly populated.

The endpoint requires a filter on productPageId. Omitting the languageCode filter returns locale details for all supported languages of the product page. Add a languageCode filter to retrieve a specific locale.

See QueryFilterOperator for the full set of supported comparison operators.

Request Body

Filterable Fields

Field	Type	Operators	Description
`productPageId`	string (UUID)	`EQUALS`	Scopes the query to a specific product page. See Key Constraints below.
`language`	string	`EQUALS`	Filter to a specific language identifier, such as `en` or `fr`.
`languageCode`	string	`EQUALS`	Filter to a specific locale, such as `en-US` or `fr-FR`.

The request body is a QueryRequest composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination.

Keep the following constraints in mind when querying locale details:

Constraint	Detail
productPageId required	A filter on `productPageId` is required. The query will return an error without it.
All locales by default	Omitting `languageCode` returns all locales configured for the product page.
assetsByDevice structure	The `assetsByDevice` field maps each specific device type (for example, `iphone_6_5`, `iphone_6_7`) to a `DeviceAssetGroup` containing an `assets` array of asset references and an `appPreviewDeviceFallBackDevices` array.

Payload Examples

HTTP Body

See QueryRequest.