Строка
  • Документация
  • API
Начало работы
    ВведениеБыстрый стартАвторизация
Руководства
Примеры
Справка
API ReferenceAPI
Начало работы

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

Пошаговая инструкция: от регистрации до экспорта контактов без маски.


  1. Зарегистрируйтесь

    Перейдите на app.strokka.com/sign-up и создайте аккаунт.

    Поиск и просмотр компаний (с маскировкой контактов) — бесплатны и не требуют кредитов. Кредиты нужны только для экспорта полных контактов.

  2. Получите API-ключ в личном кабинете

    1. Войдите на app.strokka.com
    2. Нажмите на аватар в правом верхнем углу
    3. Откройте Настройки → API
    4. Нажмите «Сгенерировать ключ» (или скопируйте уже существующий)
    5. Сохраните secretKey в надёжном месте — он понадобится для POST /companies/export

    Ключ выдаётся только через личный кабинет. Не храните его в клиентском коде и не передавайте в URL.

  3. Пополните баланс (для экспорта)

    Экспорт контактов без маски списывает кредиты: 1 кредит = 1 компания.

    Для тестовых кредитов напишите на vlad@strokka.com с почтой, на которую зарегистрировались.

  4. Сделайте первый поиск

    TerminalCode
    curl -sS --get "https://app.strokka.com/api/v1/companies" \ --data-urlencode "search=конфетная фабрика" \ --data-urlencode "searchMode=hybrid" \ --data-urlencode "limit=1" \ --data-urlencode "skip=0"

    В ответе придёт JSON. Главное — массив companies и счётчик totalCount.

    Реальный фрагмент ответа (запрос выше, limit=1):

    Code
    { "companies": [ { "id": 853533, "name": "ООО «Нальчик-сладость»", "domain": "nalslad.com", "url": "https://nalslad.com/", "description": "Кондитерская фабрика, производящая разнообразные сладости, включая конфеты, наборы конфет и суфле.", "sector": "Промышленность и производство", "region": "Кабардино-Балкария", "city": "Нальчик", "address": "г. Нальчик, ул. Кирова, 316", "email": "teh░░░░░░░░░░░com, zak░░░░░░░░░░░com, cla░░░░░░░░░░░com, …", "phone": "896░░░░░048, 8(8░░░░░░░░░-10, …", "relevance": 0.01639344262295082 } ], "totalCount": 4500, "skip": 0, "limit": 1, "searchMode": "hybrid", "normalized_query": "конфетная фабрика" }

    Что вы получаете на этом шаге (бесплатно):

    ПолеЧто этоДля экспорта
    companies[].idУникальный идентификатор (853533 в примере)Скопируйте — понадобится в companyIds
    name, domain, description, city, sectorКарточка компанииВидны полностью — можно оценить релевантность
    email, phoneКонтакты с маскойСимволы ░ скрывают часть адреса и цифр; в примере несколько email через запятую
    relevanceТехнический балл ранжированияЧем выше — тем лучше совпадение (внутри одного ответа)1
    totalCountСколько всего компаний по запросу (4500)Если больше limit — увеличьте limit или используйте skip

    Поиск не списывает кредиты. Полные email и phone (без ░) появятся только после экспорта на следующем шаге.

  5. Экспортируйте контакты без маски

    Подставьте id из ответа поиска (853533 в примере выше) и ваш secretKey из Настройки → API:

    TerminalCode
    curl -sS -X POST "https://app.strokka.com/api/v1/companies/export" \ -H "Content-Type: application/json" \ -d '{ "companyIds": [853533], "key": "ваш_secretKey_из_настроек" }'

    Та же компания, но контакты без маски. Структура ответа:

    Code
    { "companies": [ { "id": 853533, "name": "ООО «Нальчик-сладость»", "domain": "nalslad.com", "email": "полные адреса без символов ░", "phone": "полные номера без символов ░" } ], "creditsUsed": 1, "creditsRemaining": 9999 }
    ПолеЗначение
    companiesТе же карточки, но email и phone полностью
    creditsUsedСколько кредитов списано за этот запрос
    creditsRemainingОстаток на балансе после экспорта

    Кредиты списываются только за фактически найденные компании. Несуществующие ID не тарифицируются.

Что означает searchMode=hybrid?

Режим hybrid (рекомендуемый для текстового поиска) объединяет:

  • полнотекстовый поиск — точные совпадения по словам в названии, описании и т.д.;
  • векторный поиск — совпадение по смыслу запроса.

В топ попадают компании, которые одновременно хорошо совпадают по тексту и по смыслу. Поле relevance — технический балл ранжирования: чем выше, тем выше в списке.

Подробнее о режимах — Поиск, о шкалах relevance — Ранжирование.

Что дальше?

  • Примеры запросов — пошаговые сценарии по задачам
  • Поиск компаний — режимы, пагинация, структура ответа
  • Фильтры — 30+ полей, операторы AND/OR
  • Ранжирование — как читать relevance
  • Экспорт — лимиты на companyIds, exclude, кредиты
  • API Reference — полное описание эндпоинтов
Нашли ошибку?

Связаться

Footnotes

  1. Шкала зависит от searchMode: в vector — ближе к 0–1, в hybrid при слиянии результатов — небольшие значения (~0.016 у топа). Подробнее — Ранжирование и relevance. ↩

Last modified on July 3, 2026
ВведениеАвторизация
On this page
  • Что означает searchMode=hybrid?
  • Что дальше?
  • Footnotes
JSON
JSON