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

Поиск доступных сервисов с ценами и наличием номеров.

• Только country → все сервисы, доступные в этой стране
• Только service → все страны, где предлагается этот сервис
• Оба параметра → данные для конкретной комбинации сервис/страна

Endpoint поиска

Endpoint

GET /api/v1/numbers/search/

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

Параметр	Обязательно	Описание
provider	Да	virtual, residential, residential_rent
period	Да	Период, допустимый для выбранного провайдера (см. таблицу ниже)
country	Нет	Числовой код страны из GET /countries/
service	Нет	Код или slug сервиса из GET /services/

Правила провайдера и периода

Провайдер	Доступные периоды
virtual	Только MIN_15
residential	Только MIN_15
residential_rent	DAY_3, WEEK, WEEK_2, DAY_25

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

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

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_ключ'

Ответ

{
  "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": "https://sms.cyberyozh.com/reception-sms/virtual/kazakhstan/okru-40/"
    }
  ]
}

Поля ответа

Поле	Тип	Описание
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	Подробная информация о стране

Ответы с ошибками

Статус	Описание
400	Неверная или несовместимая комбинация параметров
401	Неверный или отсутствующий API-ключ
429	Превышен лимит запросов

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

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

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

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/numbers/search/?provider=virtual&country=667&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': '667',  # 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("Нет доступных номеров для этой комбинации")

Примечания

• Доступность часто меняется в зависимости от спроса
• Цены варьируются в зависимости от страны и сервиса