Поиск номеров

Поиск доступных телефонных номеров по стране, сервису, провайдеру и периоду аренды.

Поиск Endpoint

Поиск доступных номеров с гибкими фильтрами.

Endpoint

GET /api/v1/numbers/search/

Параметры запроса

Параметр	Тип	Обязательно	Описание
provider	string	Да	Тип провайдера: virtual, virtual_rent, или residential
period	string	Да	Период аренды: MIN_15, DAY, WEEK, или MONTH
country	string	Нет	Код страны из endpoint /countries/
service	string	Нет	Код сервиса из endpoint /services/

Типы провайдеров

Провайдер	Описание	Доступные периоды
virtual	Виртуальные номера для одноразового использования	Только MIN_15
virtual_rent	Виртуальные номера для длительной аренды	DAY, WEEK, MONTH
residential	Реальные резидентные мобильные номера	Только MIN_15

Примеры запросов

Поиск по стране и сервису

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/numbers/search/?provider=virtual&country=2&period=MIN_15&service=ok' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ'

Поиск только по провайдеру

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/numbers/search/?provider=virtual_rent&period=MONTH' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ'

Ответ

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 14897,
      "code": "ok",
      "name": "ok.ru",
      "slug": "okru-40",
      "icon": "/static/website/services/ok0.webp",
      "country_code": "2",
      "country_name": "Kazakhstan",
      "is_active": true,
      "count": "<1k",
      "cost": 0.09,
      "is_bookmark": false,
      "provider": "virtual",
      "period": null,
      "url": "http://sms.cyberyozh.com/reception-sms/virtual/kazakhstan/okru-40/",
      "country": {
        "id": 169,
        "slug": "kazakhstan",
        "name": "Kazakhstan",
        "code": "2",
        "country": "KZ",
        "flag": "/static/flags/kz.gif",
        "unicode_flag": "🇰🇿"
      }
    }
  ]
}

Поля ответа

Поле	Тип	Описание
count	integer	Общее количество результатов
results	array	Массив доступных предложений номеров
id	integer	Идентификатор предложения
code	string	Код сервиса
name	string	Название сервиса
country_code	string	Код страны
country_name	string	Название страны
is_active	boolean	Активно ли предложение
count	string	Количество доступных номеров
cost	number	Цена в USD
provider	string	Тип провайдера
country	object	Детальная информация о стране

Стратегии поиска

Найти все сервисы в стране

Передайте только provider, period и country:

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/numbers/search/?provider=virtual&country=666&period=MIN_15' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ'

Найти все страны для сервиса

Передайте только provider, period и service:

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/numbers/search/?provider=residential&service=tg&period=MIN_15' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ'

Пример использования

import requests

headers = {
    'accept': 'application/json',
    'X-Api-Key': 'ваш_api_ключ'
}

params = {
    'provider': 'residential',
    'period': 'MIN_15',
    'country': '666',  # USA резидентные
    'service': 'tg'    # Telegram
}

response = requests.get(
    'https://app.cyberyozh.com/api/v1/numbers/search/',
    headers=headers,
    params=params
)

results = response.json()
if results['count'] > 0:
    offering = results['results'][0]
    print(f"Доступно: {offering['name']} в {offering['country_name']}")
    print(f"Цена: ${offering['cost']}")
else:
    print("Нет доступных номеров для этой комбинации")

Примечания

• Доступность часто меняется в зависимости от спроса
• Цены варьируются в зависимости от страны и сервиса
• Используйте возвращенный id из результатов при заказе номеров