Примеры

Поиск и первый экспорт

Типичная задача: найти компании по запросу и получить полные email и телефон. Поиск бесплатен; кредиты списываются только на шаге экспорта.

Что понадобится: аккаунт на app.strokka.com, API-ключ из Настройки → API, баланс кредитов (1 кредит = 1 компания).

Найдите компании (бесплатно)

Запрос с текстовым поиском в режиме hybrid — сочетает точные совпадения и поиск по смыслу:

Code
curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "search=маркетинговое агентство" \
  --data-urlencode "searchMode=hybrid" \
  --data-urlencode "limit=10" \
  --data-urlencode "skip=0"

Что смотреть в ответе:

Поле	Зачем
`totalCount`	Сколько всего компаний по запросу
`companies[].id`	Нужен для экспорта
`companies[].email`, `phone`	С маской — `in**@example.com`
`relevance`	Технический балл ранжирования (чем выше — тем лучше в выдаче)

Подробнее о режимах поиска — в разделе Поиск.

Скопируйте id компаний

Из массива companies возьмите поле id у тех карточек, которые хотите экспортировать. Например: 123456, 789012, 345678.

Если компаний больше 10 — увеличьте limit (макс. 1000) или используйте пагинацию через skip. См. Массовая выгрузка.
Экспортируйте полные контакты

Подставьте собранные id и ваш secretKey:
```
Code
curl -sS -X POST "https://app.strokka.com/api/v1/companies/export" \
  -H "Content-Type: application/json" \
  -d '{
    "companyIds": [123456, 789012, 345678],
    "key": "ваш_secretKey"
  }'
```
Что смотреть в ответе:

Поле Значение
companies Полные контакты без маски
creditsUsed Сколько кредитов списано
creditsRemaining Остаток на балансе
Проверьте результат
- creditsUsed должен совпадать с числом фактически возвращённых компаний
- Несуществующие id не попадают в ответ и не тарифицируются
- При неверном ключе — 401, при нехватке кредитов — 402

Поле	Значение
`companies`	Полные контакты без маски
`creditsUsed`	Сколько кредитов списано
`creditsRemaining`	Остаток на балансе

Оценить объём до экспорта

Минимальный limit — 1. Сделайте поиск с теми же параметрами, что и для выгрузки, укажите limit=1 и смотрите totalCount в ответе (поиск бесплатен, вернётся одна карточка):

Code
curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "search=маркетинговое агентство" \
  --data-urlencode "searchMode=hybrid" \
  --data-urlencode "limit=1"

Сравните totalCount с creditsRemaining на балансе.

Что дальше?

Фильтрация выборки — сузить результаты по городу, отрасли, email
Массовая выгрузка — тысячи компаний за раз
Экспорт и кредиты — параметры POST /companies/export

Нашли ошибку?

Связаться

Last modified on July 3, 2026

Примеры запросов Фильтрация выборки

Code

curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "search=маркетинговое агентство" \
  --data-urlencode "searchMode=hybrid" \
  --data-urlencode "limit=10" \
  --data-urlencode "skip=0"

Поле

Зачем

totalCount

Сколько всего компаний по запросу

companies[].id

Нужен для экспорта

companies[].email, phone

С маской — in**@example.com

relevance

Технический балл ранжирования (чем выше — тем лучше в выдаче)

Code

curl -sS -X POST "https://app.strokka.com/api/v1/companies/export" \
  -H "Content-Type: application/json" \
  -d '{
    "companyIds": [123456, 789012, 345678],
    "key": "ваш_secretKey"
  }'

Поле	Значение
`companies`	Полные контакты без маски
`creditsUsed`	Сколько кредитов списано
`creditsRemaining`	Остаток на балансе

Поле

Значение

companies

Полные контакты без маски

creditsUsed

Сколько кредитов списано

creditsRemaining

Остаток на балансе

Оценить объём до экспорта

Code

curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "search=маркетинговое агентство" \
  --data-urlencode "searchMode=hybrid" \
  --data-urlencode "limit=1"

Сравните totalCount с creditsRemaining на балансе.