Быстрый старт
Пошаговая инструкция: от регистрации до экспорта контактов без маски.
-
Зарегистрируйтесь
Перейдите на app.strokka.com/sign-up и создайте аккаунт.
Поиск и просмотр компаний (с маскировкой контактов) — бесплатны и не требуют кредитов. Кредиты нужны только для экспорта полных контактов.
-
Получите API-ключ в личном кабинете
- Войдите на app.strokka.com
- Нажмите на аватар в правом верхнем углу
- Откройте Настройки → API
- Нажмите «Сгенерировать ключ» (или скопируйте уже существующий)
- Сохраните
secretKeyв надёжном месте — он понадобится дляPOST /companies/export
Ключ выдаётся только через личный кабинет. Не храните его в клиентском коде и не передавайте в URL.
-
Пополните баланс (для экспорта)
Экспорт контактов без маски списывает кредиты: 1 кредит = 1 компания.
Для тестовых кредитов напишите на vlad@strokka.com с почтой, на которую зарегистрировались.
-
Сделайте первый поиск
CodeВ ответе придёт JSON. Главное — массив
companiesи счётчикtotalCount.Реальный фрагмент ответа (запрос выше,
limit=1):CodeЧто вы получаете на этом шаге (бесплатно):
Поле Что это Для экспорта companies[].idУникальный идентификатор ( 853533в примере)Скопируйте — понадобится в companyIdsname,domain,description,city,sectorКарточка компании Видны полностью — можно оценить релевантность email,phoneКонтакты с маской Символы ░скрывают часть адреса и цифр; в примере несколько email через запятуюrelevanceТехнический балл ранжирования Чем выше — тем лучше совпадение (внутри одного ответа)1 totalCountСколько всего компаний по запросу ( 4500)Если больше limit— увеличьтеlimitили используйтеskipПоиск не списывает кредиты. Полные
emailиphone(без░) появятся только после экспорта на следующем шаге. -
Экспортируйте контакты без маски
Подставьте
idиз ответа поиска (853533в примере выше) и вашsecretKeyиз Настройки → API:CodeТа же компания, но контакты без маски. Структура ответа:
CodeПоле Значение companiesТе же карточки, но emailиphoneполностьюcreditsUsedСколько кредитов списано за этот запрос creditsRemainingОстаток на балансе после экспорта Кредиты списываются только за фактически найденные компании. Несуществующие ID не тарифицируются.
Что означает searchMode=hybrid?
Режим hybrid (рекомендуемый для текстового поиска) объединяет:
- полнотекстовый поиск — точные совпадения по словам в названии, описании и т.д.;
- векторный поиск — совпадение по смыслу запроса.
В топ попадают компании, которые одновременно хорошо совпадают по тексту и по смыслу. Поле relevance — технический балл ранжирования: чем выше, тем выше в списке.
Подробнее о режимах — Поиск, о шкалах relevance — Ранжирование.
Что дальше?
- Примеры запросов — пошаговые сценарии по задачам
- Поиск компаний — режимы, пагинация, структура ответа
- Фильтры — 30+ полей, операторы AND/OR
- Ранжирование — как читать
relevance - Экспорт — лимиты на
companyIds,exclude, кредиты - API Reference — полное описание эндпоинтов
Связаться
Footnotes
-
Шкала зависит от
searchMode: вvector— ближе к 0–1, вhybridпри слиянии результатов — небольшие значения (~0.016 у топа). Подробнее — Ранжирование и relevance. ↩