Contents

Get Localized App Details

Fetches the localized default product page for an app.

URL

GET https://api.searchads.apple.com/api/v5/apps/{adamId}/locale-details

Path Parameters

NameTypeDescription
adamId Requiredint64

Your unique App Store app identifier.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
MediaLocaleDetailResponse

If successful, the API returns a list of objects in the response payload with an HTTP status code of 200 (OK). If unsuccessful, the HTTP status code indicates the error with details in the error message.

400Bad Request
Content-Type: application/json
ApiErrorResponse
401Unauthorized
Content-Type: application/json
ApiErrorResponse

An unauthenticated call fails to get the requested response.

403Forbidden
Content-Type: application/json
ApiErrorResponse

Insufficient rights to the resource.

404Not Found
Content-Type: application/json
ApiErrorResponse
429
Content-Type: application/json
ApiErrorResponse

The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API.

500Internal 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.

Mentioned in

Discussion

Use this endpoint to return localized app details using your adamId in the resource path. Related objects: MediaLocaleDetail, MediaLocaleDetailResponse.

Query Parameters

  • expand: Detailed app asset details of a device. Use true for expanded values in the API response.

Get localized app details example

See Also

App Details