Данные телефонных кодов в JSON

Надёжно определяйте телефонные номера, коды и страны.

API phonecode.app предоставляет структурированные данные о местных и международных телефонных кодах, сервисных и экстренных номерах, а также преобразование местных номеров в международный формат. Для магазинов, CRM, средств поддержки, форм потенциальных клиентов и внутреннего контроля качества данных.

Создать ключ Быстрый старт

GET /api/search.php?q=030 JSON

{
  "ok": true,
  "query": "030",
  "results": [
    {
      "code": "030",
      "name": "Berlin",
      "region": "Deutschland",
      "kind": "Ort",
      "format": "+49 30"
    }
  ]
}

28 608 Записи

5 200 Местные сети Германии

206 страны и территории

76 Сервисные и экстренные диапазоны

382 Мобильные диапазоны

Быстрый старт

Первый запрос за несколько минут.

Подтвердите аккаунт

Зарегистрируйтесь в личном кабинете и подтвердите адрес электронной почты.

Создать ключ

Создайте ключ API. В открытом виде он показывается только один раз.

Получите JSON

Передавайте ключ только как Bearer Token в заголовке Authorization.

Bearer Token

curl "https://vorwahl.app/api/search.php?q=040" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

Передавайте ключи безопасно

Ключи API не должны попадать в URL, историю браузера, журналы прокси или адреса переходов. Поэтому параметры запроса не принимаются.

Конечные точки

Понятные конечные точки JSON для поиска, аккаунтов и оплаты.

GET

/api/search.php

Ищет телефонные коды, номера, населённые пункты, страны, сервисные и экстренные номера.

Параметр	Описание
q	Поисковый запрос, например `030`, `Berlin`, `+44`, `0800`.
limit	Необязательно, от 1 до 50 результатов. По умолчанию: 12.

GET

/api/internationalize.php

Преобразует местный номер страны в международный формат для копирования.

Параметр	Описание
number	Местный номер, например `0343 222 1234`.
country	Код страны номера по ISO, например `GB`, `DE`, `AT`. По умолчанию: `DE`.

curl "https://vorwahl.app/api/internationalize.php?number=0343%20222%201234&country=GB" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

{
  "ok": true,
  "input": "0343 222 1234",
  "country": "GB",
  "international": "+44 343 222 1234"
}

GET

/api/health.php

Возвращает состояние и текущие счётчики данных.

GET

/api/billing/plans.php

Возвращает доступные тарифы API, лимиты и состояние PayPal.

POST

/api/account/api-keys.php

Создаёт ключ API для вошедших пользователей с подтверждённым аккаунтом.

Формат ответа

Каждый результат содержит данные для отображения, проверки и форматирования.

codeТелефонный код или диапазон номеров, например 030 или +49.

nameНаселённый пункт, страна, сервис или название экстренной службы.

kindOrt, Land, Region, Dienst, Notruf.

local_formatРекомендуемый национальный формат отображения.

international_formatРекомендуемый международный формат отображения.

adviceПонятная подсказка о стоимости, использовании или способе набора.

планы API

Предсказуемые месячные квоты со справедливым бесплатным использованием.

Das Lizenzangebot richtet sich ausschließlich an Unternehmen. Aufgrund der Kleinunternehmerregelung gemäß § 19 UStG wird keine Umsatzsteuer berechnet.