Storelift

Storelift › Руководства › Коды стран витрин App Store

Магазин

Коды стран витрин App Store

Списки витрин ходят по сети в виде скопированных gist'ов, а неверный ID себя не выдаёт: Apple отвечает на запрос и возвращает ничего, и это читается как «в этой стране нет спроса», а не как ошибка. Каждая строка ниже измерена по трём эндпоинтам Apple 2026-09-23. 2 кандидата не прошли проверку и исключены.

Начать бесплатно →Бесплатный план: 1 приложение, по 25 ключевых слов в 2 витринах, 30 дней истории, без карты и без срока. Pro — $20/мес.

Автор: Переведено с английского оригинала с помощью ИИОбновлено: Разделов: 6

01Как используются значения

Три разных значения выполняют три разные задачи, и путаница между ними — обычная причина пустого результата:

  • Код страны — двухбуквенный код, который публичные эндпоинты iTunes принимают как country=. Его понимают /search и /lookup.
  • Заголовок витрины — значение заголовка запроса X-Apple-Store-Front в форме <id>,29. Суффикс ,29 — это часть платформы; заголовок с голым ID молча ничего не возвращает.
  • Язык по умолчанию — значение lang=, которое Apple принимает для этой витрины. Недопустимое отклоняется сразу; допустимое, но неверное тихо меняет вид выдачи, потому что результаты читаются на этом языке.
Столбец языка — не полный список языков витрины. Apple во многих странах обслуживает несколько языков; здесь указан язык по умолчанию, который мы измерили и в котором читают наши собственные замеры. Там, где мы работаем в продакшене, значение зафиксировано на том, что было отлажено на практике, — турецкие результаты без tr_tr плывут.

02Как проверялась каждая строка

  1. Подсказки поиска. Запрос подсказок отправляется с заголовком X-Apple-Store-Front. Настоящая витрина возвращает 10 предложенных запросов; выдуманный ID — 0. Именно эта проверка ловит неверный ID.
  2. Язык. Выполняется lookup с lang=. Apple явно отклоняет недопустимое значение: Invalid value(s) for key(s): [language]. Кандидаты пробуются начиная с местного языка, и сохраняется первый принятый.
  3. Страна. Тот же lookup выполняется с country=. Недопустимый код отклоняется так же. /lookup используется вместо /search намеренно: у /search настолько жёсткое ограничение частоты, что запрос по 130 странам заставляет Apple вернуть 403, а 403 неотличим от «в этой стране нет результатов».

Строка публикуется, только если пройдены все три проверки. Сами ID взяты из двух независимых публичных списков, которые согласуются друг с другом и с 27 витринами, уже работающими в продакшене, — но согласие списков не доказательство, поэтому каждая всё равно измерена.

032 исключённые витрины

Бангладеш (bd) и Лихтенштейн (li) есть в распространённых списках с ID витрин, и Apple принимает оба кода без ошибки. И всё же они не проходят: запрос подсказок возвращает 0 запросов, а lookup по известному приложению возвращает "resultCount":0.

Это ровно тот сбой, ради которого существует список. Ничего не выдаёт ошибку. Запрос успешен, ответ пуст, и инструмент, построенный на нём, сообщает, что в стране нет спроса. Обе строки удалены, а не опубликованы с оговоркой.

04Все 175 витрин

СтранаКодID витриныX-Apple-Store-FrontЯзык по умолчанию
Австралияau143460143460,29en_au
Австрияat143445143445,29de_de
Азербайджанaz143568143568,29ru_ru
Албанияal143575143575,29en_gb
Алжирdz143563143563,29ar_sa
Ангильяai143538143538,29en_gb
Анголаao143564143564,29pt_pt
Антигуа и Барбудаag143540143540,29en_gb
Аргентинаar143505143505,29es_mx
Арменияam143524143524,29ru_ru
Афганистанaf143610143610,29en_gb
Багамыbs143539143539,29en_gb
Барбадосbb143541143541,29en_gb
Бахрейнbh143559143559,29ar_sa
Беларусьby143565143565,29ru_ru
Белизbz143555143555,29en_gb
Бельгияbe143446143446,29nl_nl
Бенинbj143576143576,29en_gb
Бермудские о-ваbm143542143542,29en_gb
Болгарияbg143526143526,29bg_bg
Боливияbo143556143556,29es_mx
Босния и Герцеговинаba143612143612,29en_gb
Ботсванаbw143525143525,29en_gb
Бразилияbr143503143503,29pt_br
Брунейbn143560143560,29en_gb
Буркина-Фасоbf143578143578,29en_gb
Бутанbt143577143577,29en_gb
Вануатуvu143609143609,29en_gb
Великобританияgb143444143444,29en_gb
Венгрияhu143482143482,29hu_hu
Венесуэлаve143502143502,29es_mx
Виргинские о-ва (Великобритания)vg143543143543,29en_gb
Вьетнамvn143471143471,29vi_vn
Габонga143614143614,29fr_fr
Гайанаgy143553143553,29en_gb
Гамбияgm143584143584,29en_gb
Ганаgh143573143573,29en_gb
Гватемалаgt143504143504,29es_mx
Гвинея-Бисауgw143585143585,29en_gb
Германияde143443143443,29de_de
Гондурасhn143510143510,29es_mx
Гонконг (САР)hk143463143463,29zh_hk
Гренадаgd143546143546,29en_gb
Грецияgr143448143448,29el_gr
Грузияge143615143615,29en_gb
Данияdk143458143458,29da_dk
Доминикаdm143545143545,29en_gb
Доминиканская Республикаdo143508143508,29es_mx
Египетeg143516143516,29ar_sa
Замбияzm143622143622,29en_gb
Зимбабвеzw143605143605,29en_gb
Израильil143491143491,29en_gb
Индияin143467143467,29en_in
Индонезияid143476143476,29en_us
Иорданияjo143528143528,29ar_sa
Иракiq143617143617,29en_gb
Ирландияie143449143449,29en_gb
Исландияis143558143558,29is_is
Испанияes143454143454,29es_es
Италияit143450143450,29it_it
Йеменye143571143571,29ar_sa
Кабо-Вердеcv143580143580,29en_gb
Казахстанkz143517143517,29ru_ru
Камбоджаkh143579143579,29en_gb
Камерунcm143574143574,29fr_fr
Канадаca143455143455,29en_ca
Катарqa143498143498,29ar_sa
Кенияke143529143529,29en_gb
Кипрcy143557143557,29el_gr
Киргизияkg143586143586,29en_gb
Китайcn143465143465,29zh_cn
Колумбияco143501143501,29es_mx
Конго - Браззавильcg143582143582,29en_gb
Конго - Киншасаcd143613143613,29en_gb
Косовоxk143624143624,29en_gb
Коста-Рикаcr143495143495,29es_mx
Кот-д’Ивуарci143527143527,29fr_fr
Кувейтkw143493143493,29ar_sa
Лаосla143587143587,29en_gb
Латвияlv143519143519,29lv_lv
Либерияlr143588143588,29en_gb
Ливанlb143497143497,29ar_sa
Ливияly143567143567,29en_gb
Литваlt143520143520,29lt_lt
Люксембургlu143451143451,29fr_fr
Маврикийmu143533143533,29en_gb
Мавританияmr143590143590,29en_gb
Мадагаскарmg143531143531,29fr_fr
Макао (САР)mo143515143515,29zh_hk
Малавиmw143589143589,29en_gb
Малайзияmy143473143473,29ms_my
Малиml143532143532,29fr_fr
Мальдивыmv143488143488,29en_gb
Мальтаmt143521143521,29en_gb
Мароккоma143620143620,29en_gb
Мексикаmx143468143468,29es_mx
Мозамбикmz143593143593,29en_gb
Молдоваmd143523143523,29ro_ro
Монголияmn143592143592,29en_gb
Монтсерратms143547143547,29en_gb
Мьянма (Бирма)mm143570143570,29en_gb
Намибияna143594143594,29en_gb
Науруnr143606143606,29en_gb
Непалnp143484143484,29en_gb
Нигерne143534143534,29fr_fr
Нигерияng143561143561,29en_gb
Нидерландыnl143452143452,29nl_nl
Никарагуаni143512143512,29es_mx
Новая Зеландияnz143461143461,29en_au
Норвегияno143457143457,29nb_no
о-ва Кайманky143544143544,29en_gb
ОАЭae143481143481,29en_us
Оманom143562143562,29ar_sa
Пакистанpk143477143477,29en_gb
Палауpw143595143595,29en_gb
Панамаpa143485143485,29es_mx
Папуа — Новая Гвинеяpg143597143597,29en_gb
Парагвайpy143513143513,29es_mx
Перуpe143507143507,29es_mx
Польшаpl143478143478,29pl_pl
Португалияpt143453143453,29pt_pt
Республика Кореяkr143466143466,29ko_kr
Россияru143469143469,29ru_ru
Руандаrw143621143621,29en_gb
Румынияro143487143487,29ro_ro
Сальвадорsv143506143506,29es_mx
Сан-Томе и Принсипиst143598143598,29en_gb
Саудовская Аравияsa143479143479,29ar_sa
Северная Македонияmk143530143530,29en_gb
Сейшельские о-ваsc143599143599,29en_gb
Сенегалsn143535143535,29fr_fr
Сент-Винсент и Гренадиныvc143550143550,29en_gb
Сент-Китс и Невисkn143548143548,29en_gb
Сент-Люсияlc143549143549,29en_gb
Сербияrs143500143500,29en_gb
Сингапурsg143464143464,29en_gb
Словакияsk143496143496,29sk_sk
Словенияsi143499143499,29sl_si
Соединенные Штатыus143441143441,29en_us
Соломоновы о-ваsb143601143601,29en_gb
Суринамsr143554143554,29en_gb
Сьерра-Леонеsl143600143600,29en_gb
Таджикистанtj143603143603,29en_gb
Таиландth143475143475,29th_th
Тайваньtw143470143470,29zh_tw
Танзанияtz143572143572,29en_gb
Тёркс и Кайкосtc143552143552,29en_gb
Тонгаto143608143608,29en_gb
Тринидад и Тобагоtt143551143551,29en_gb
Тунисtn143536143536,29ar_sa
Туркменистанtm143604143604,29en_gb
Турцияtr143480143480,29tr_tr
Угандаug143537143537,29en_gb
Узбекистанuz143566143566,29ru_ru
Украинаua143492143492,29uk_ua
Уругвайuy143514143514,29es_mx
Федеративные Штаты Микронезииfm143591143591,29en_gb
Фиджиfj143583143583,29en_gb
Филиппиныph143474143474,29en_gb
Финляндияfi143447143447,29fi_fi
Францияfr143442143442,29fr_fr
Хорватияhr143494143494,29hr_hr
Чадtd143581143581,29en_gb
Черногорияme143619143619,29en_gb
Чехияcz143489143489,29cs_cz
Чилиcl143483143483,29es_mx
Швейцарияch143459143459,29de_de
Швецияse143456143456,29sv_se
Шри-Ланкаlk143486143486,29en_gb
Эквадорec143509143509,29es_mx
Эсватиниsz143602143602,29en_gb
Эстонияee143518143518,29et_ee
Южно-Африканская Республикаza143472143472,29en_gb
Ямайкаjm143511143511,29en_gb
Японияjp143462143462,29ja_jp
Скачать: app-store-storefronts-2026-09-23.csv — 175 строк: код страны, название страны на английском и турецком, ID витрины, значение заголовка и код языка. Пересобрать: node tools/publish_storefronts.mjs.

05Тот же список, прочитанный по языкам

Таблица выше читается от витрины к языку. Решение в ASO обычно идёт в обратную сторону: написать текст один раз — и сколько витрин его прочитает? 175 витрин распадаются на 13 языковых слотов, охватывающих больше одной витрины, и у каждого слота своя страница.

  • en-GB — 85 витрин
  • es-MX — 17 витрин
  • ar-SA — 11 витрин
  • fr-FR — 9 витрин
  • ru-RU — 6 витрин
  • de-DE — 3 витрины
  • en-US — 3 витрины
  • el-GR — 2 витрины
  • en-AU — 2 витрины
  • nl-NL — 2 витрины
  • pt-PT — 2 витрины
  • ro-RO — 2 витрины
  • zh-HK — 2 витрины

06Код страны App Store и ID витрины

Это два разных значения, и в большинстве неудачных запросов их путают. Код страны — двухбуквенный; ID витрины — шестизначное число Apple, которое отправляется в заголовке с суффиксом ,29:

СтранаКод страныID витриныX-Apple-Store-Front
СШАus143441143441,29
Великобританияgb143444143444,29
Германияde143443143443,29
Японияjp143462143462,29
Турцияtr143480143480,29

Великобритания — это gb, а не uk. Что такое витрина — см. витрина; как позиция читается по витринам — отслеживание позиций по ключевым словам App Store.

Частые вопросы

Почему мой запрос возвращает пустой результат, а не ошибку?

Почти всегда дело в заголовке. Неверный ID витрины или ID без суффикса платформы ,29 — это корректно сформированный запрос, на который Apple отвечает ничем. Ошибки, которую можно поймать, нет, поэтому список нужно измерять, а не принимать на веру.

Охватывает ли список все страны App Store?

Он охватывает все витрины, прошедшие все три проверки, — 175. Витрина включается, только когда её идентификатор возвращает собственные результаты этой страны и мы можем надёжно читать там позиции; 2 кандидата не прошли проверку и исключены, а не угаданы.

Столбец языка — это полный список языков стора?

Нет. Это язык по умолчанию, который мы измерили и в котором читаем результаты. Во многих витринах Apple обслуживает несколько языков; столбец отвечает на вопрос «какое значение принимает Apple и какое читаем мы», а не «какие языки там есть».

Как часто это перемеряется?

Замер повторяется, когда добавляется витрина или замер начинает давать сбои. Дата на странице — дата последнего запуска: если она старая, то и список старый, и мы лучше покажем это, чем скроем.

Какой ID витрины App Store у США?

143441. В заголовке запроса он отправляется как X-Apple-Store-Front: 143441,29; код страны для публичных эндпоинтов iTunes — us.

Какой код страны App Store у Великобритании?

gb, ID витрины 143444. uk не является кодом страны App Store.

Можно ли скачать список витрин App Store в CSV?

Да: в app-store-storefronts-2026-09-23.csv все 175 строк с кодом страны, названием страны на английском и турецком, ID витрины, значением заголовка и кодом языка.

Проверьте на своём приложении

Вставьте ссылку на приложение и добавьте ключевые слова. Позиция, приложения выше вас и спрос измеряются каждый день.

Бесплатный план: 1 приложение, по 25 ключевых слов в 2 витринах, 30 дней истории, без карты и без срока. Pro — $20/мес.

Начать бесплатно →

Читайте также