---
title: "Write the full App Store listing for a new locale — name, subtitle, keyword field and description — from…"
method: GET
path: "/apps/{appId}/localize"
tags: ["Apps"]
---

# Write the full App Store listing for a new locale — name, subtitle, keyword field and description — from…

`GET /apps/{appId}/localize`

## Request

- Base URL: `https://storelift.net/v1`
- URL: `https://storelift.net/v1/apps/{appId}/localize`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Write the full App Store listing for a new locale — name, subtitle, keyword field and description — from the app's source listing, with every keyword measured in that storefront first. The first call starts the write and answers pending (it takes one listing write from the workspace's allowance; get_usage shows what is left); call again with poll=true until the listing comes back. With shots=true the screenshot captions come back in the same language too. Needs get_storefront_audit to have run for the app. Writes nothing to App Store Connect; update_listing does that.

## Path parameters

- `appId` string, required

## Query parameters

- `locale` string, required

## Response `200`

OK

- object

## Other responses

- `400`: A parameter is missing or malformed.
- `401`: No key, or the key is not valid.
- `402`: This month's credits are used up.
- `403`: The key's plan or scopes do not cover this call.
- `404`: No such app, or Storelift has not measured it yet.
- `429`: Too many requests.

---

[API](https://skmtc.dev/storelift/apis/storelift-api.md) · [All operations](https://skmtc.dev/storelift/apis/storelift-api/llms.txt) · [OpenAPI document](https://skmtc.dev/storelift/apis/storelift-api/revisions/4489f2d077a4?raw)