REST API КОНТРАКТ · osint-score-api-v1

Промышленный API обогащения лидов, Instagram и Telegram.

Подключите ваш сервер парсинга комментариев Instagram, Telegram-ботов, колл-центр или CRM напрямую к ядру OSINT/SCORE. Поддерживается одиночное раскрытие номеров (20 ₽), двойной пробив по 52 реестрам РФ (20 + 20 ₽) и пакетная обработка до 500 контактов за вызов с выгрузкой CSV и PDF.

Скачать OpenAPI 3.0.3 (JSON) Подключение Instagram-сервера Пакетный Bulk API Открыть консоль

01. Авторизация и корпоративный ключ

Все вызовы API v1 авторизуются ключом организации (начинается с sk_live_...). Получить или перевыпустить ключ можно в кабинете: «API & Интеграции».

Сервер принимает ключ в любом из двух стандартных HTTP-заголовков:

Authorization: Bearer sk_live_ваш_ключ (рекомендуемый стандарт)
X-API-Key: sk_live_ваш_ключ (для конструкторов интеграций, n8n, Make и прокси-серверов)

Безопасность: передача ключа в query-параметрах URL (?api_key=...) при проверке соединения отклоняется с кодом 401, чтобы секреты не попадали в логи прокси и браузерную историю.

02. Бесплатная проверка соединения

Метод GET /console/api/v1/connection проверяет валидность ключа, статус корпоративного аккаунта и возвращает список всех активных эндпоинтов. Списания средств не происходит.

curl -sS "https://osint-score.ru/console/api/v1/connection"   -H "Authorization: Bearer ${OSINT_API_KEY}"

Ответ 200 OK

{
  "ok": true,
  "api_version": "osint-score-api-v1",
  "scope": "full_enrichment_api",
  "organization": {
    "id": "org-recplace",
    "name": "RecPlace"
  },
  "capabilities": {
    "health": true,
    "pricing_catalog": true,
    "connection_check": true,
    "creates_jobs": true,
    "instagram_enrich": true,
    "telegram_resolve": true,
    "phone_enrich": true,
    "inn_enrich": true,
    "bulk_enrich": true,
    "csv_export": true,
    "pdf_brief": true,
    "automatic_callbacks": false
  },
  "readiness": {
    "connection": "verified",
    "ready_for_profile_export": true,
    "status_machine": "active"
  },
  "endpoints": {
    "instagram_enrich": "/console/api/v1/instagram/enrich",
    "telegram_resolve": "/console/api/v1/telegram/resolve-phone",
    "phone_enrich": "/console/api/v1/phone/enrich",
    "inn_enrich": "/console/api/v1/inn/enrich",
    "bulk_enrich": "/console/api/v1/enrich/bulk",
    "bulk_status": "/console/api/v1/enrich/bulk/{batch_id}",
    "bulk_export_csv": "/console/api/v1/enrich/bulk/{batch_id}/export",
    "job_status": "/console/api/v1/jobs/{job_id}",
    "job_pdf": "/console/api/v1/jobs/{job_id}/pdf"
  }
}

03. Сводная таблица методов API v1

Метод и маршрут	Назначение	Тарификация
GET `/console/api/v1/connection`	Проверка ключа организации и карты возможностей API	Бесплатно
POST `/console/api/v1/instagram/enrich`	Обогащение аккаунта Instagram (поиск скрытого номера телефона + опционально 52 реестра РФ)	`20 ₽` (simple) / `20+20 ₽` (double)
POST `/console/api/v1/telegram/resolve-phone`	Раскрытие номера телефона по `@username` или ссылке `t.me/...`	`20 ₽` при нахождении номера
POST `/console/api/v1/phone/enrich`	Полное досье физлица по номеру телефона РФ (52 реестра + AI-портрет)	`20 ₽` (повторно — `0 ₽`)
POST `/console/api/v1/inn/enrich`	Проверка ЮЛ/ИП по ИНН: ЕГРЮЛ, выручка, директор, учредители и их телефоны	`20 ₽`
POST `/console/api/v1/enrich/bulk`	Пакетная загрузка списка (Instagram, Telegram, телефоны РФ, ИНН — до 500 шт.)	`20 ₽` за новый контакт
GET `/console/api/v1/enrich/bulk/{batch_id}`	Статус пакета и массив `items` с найденными телефонами и досье	Бесплатно
GET `/console/api/v1/enrich/bulk/{batch_id}/export`	Скачивание готовой таблицы результатов пакета в CSV (`?mode=simple\|full`)	Бесплатно
GET `/console/api/v1/jobs/{job_id}`	Получение полной JSON-карточки досье 52 реестров по `job_id`	Бесплатно
GET `/console/api/v1/jobs/{job_id}/pdf`	Скачивание брендированного PDF-досье (Executive Brief)	Бесплатно

04. Подключение сервера сбора комментариев Instagram

Для обогащения каждого нового комментатора в реальном времени отправляйте POST запрос на /console/api/v1/instagram/enrich (также поддерживается алиас /console/api/search-instagram).

Режим "mode": "simple" (20 ₽) — только быстрый поиск и фиксация номера телефона (из закрытых баз OSINT, Telegram-привязок и bio) без запуска 52 реестров РФ.
Режим "mode": "double" (20 ₽ + 20 ₽ при нахождении телефона) — поиск номера + автоматический запуск полного досье по 52 реестрам РФ (возвращает job_id).

curl -X POST "https://osint-score.ru/console/api/v1/instagram/enrich"   -H "Authorization: Bearer ${OSINT_API_KEY}"   -H "Content-Type: application/json"   -d '{
    "username": "@voldemarkram",
    "mode": "simple"
  }'

Пример ответа

{
  "ok": true,
  "reused": false,
  "mode": "simple",
  "linked_phone": "+79181234567",
  "double_triggered": false,
  "job_id": null,
  "profile": {
    "username": "voldemarkram",
    "linked_phone": "+79181234567",
    "profile_data": {
      "full_name": "Владимир Крамаров",
      "contacts": {
        "phones": ["+79181234567"]
      }
    }
  }
}

05. Раскрытие номера телефона по Telegram (@username)

Метод POST /console/api/v1/telegram/resolve-phone принимает @username или ссылку https://t.me/... и возвращает найденный мобильный номер.

curl -X POST "https://osint-score.ru/console/api/v1/telegram/resolve-phone"   -H "Authorization: Bearer ${OSINT_API_KEY}"   -H "Content-Type: application/json"   -d '{
    "username": "@durov",
    "double_enrich": false
  }'

06. Пакетное обогащение списков (Bulk API) и экспорт CSV

Если ваш сервер накопил пачку комментаторов Instagram, аккаунтов Telegram, номеров телефонов или ИНН (до 500 штук), отправьте их одним запросом в POST /console/api/v1/enrich/bulk:

curl -X POST "https://osint-score.ru/console/api/v1/enrich/bulk"   -H "Authorization: Bearer ${OSINT_API_KEY}"   -H "Content-Type: application/json"   -d '{
    "batch_type": "instagram",
    "mode": "simple",
    "name": "Комментаторы Reels #42",
    "usernames": ["@user_one", "@user_two", "https://instagram.com/user_three"]
  }'

Ответ при создании пакета

{
  "ok": true,
  "batch_id": "9f8c2b10-44a1-4c2e-9b11-0123456789ab",
  "batch_type": "instagram",
  "mode": "simple",
  "total_submitted": 3,
  "reused_count": 0,
  "queued_count": 3,
  "status_url": "https://osint-score.ru/console/api/v1/enrich/bulk/9f8c2b10-44a1-4c2e-9b11-0123456789ab",
  "export_csv_url": "https://osint-score.ru/console/api/v1/enrich/bulk/9f8c2b10-44a1-4c2e-9b11-0123456789ab/export?mode=simple"
}

Для проверки готовности опрашивайте status_url (GET /console/api/v1/enrich/bulk/{batch_id}) с тем же заголовком Authorization: Bearer. В массиве items возвращаются все профили и найденные поля phone. Готовый CSV скачивается по export_csv_url.

07. Пробив по номеру телефона РФ (52 реестра) и ИНН

Для запуска глубокого исследования по номеру телефона используйте POST /console/api/v1/phone/enrich, а для проверки компании или ИП — POST /console/api/v1/inn/enrich:

# 1. Пробив по номеру телефона РФ (52 реестра)
curl -X POST "https://osint-score.ru/console/api/v1/phone/enrich"   -H "Authorization: Bearer ${OSINT_API_KEY}"   -H "Content-Type: application/json"   -d '{"phone": "+79990000000", "report_preset": "general"}'

# 2. Проверка компании/ИП по ИНН с извлечением телефонов руководства
curl -X POST "https://osint-score.ru/console/api/v1/inn/enrich"   -H "Authorization: Bearer ${OSINT_API_KEY}"   -H "Content-Type: application/json"   -d '{"inn": "7707083893", "double_enrichment": true}'

OSINT/SCORE · Спецификация osint-score-api-v1 (OpenAPI 3.0.3) · Базовый адрес https://osint-score.ru.