Руководства

Фильтры

Strokka API поддерживает гибкую фильтрацию по 30+ полям с логическими условиями AND/OR.

Формат фильтров

В GET-запросе

Каждое условие задаётся тройкой в имени параметра:

Code
filter[<поле>][<оператор>][<логика>]=<значение>

• логика — and / or; для первого условия не используется
• Для нескольких условий повторите параметр нужное число раз

Пример (в curl квадратные скобки в URL нужно кодировать — иначе bad range in URL):

Code
curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "filter[city][eq][and]=Москва" \
  --data-urlencode "filter[sector][contains][and]=информ" \
  --data-urlencode "limit=20"

В POST-запросе

Фильтры передаются как массив объектов в поле filters:

Code
{
  "filters": [
    {"field": "city", "operator": "eq", "value": "Москва", "logic": "and"},
    {"field": "sector", "operator": "contains", "value": "информ", "logic": "and"}
  ]
}

Типы полей и операторы

Текстовые поля

domain · name · description · sector · region · city · url · phone · email · whatsapp · telegram · vkontakte · odnoklassniki · youtube · twitter · linkedin · facebook · instagram · tiktok · pinterest · viber · dzen · employees · keywords · location · yandex_maps

Справочники: сектор, регион и город

Для полей sector, region, city и виртуального location используйте справочники — в ответе поле filterValue готово для фильтра:

Фильтр	Эндпоинт
sector	GET /dictionaries/sectors
region, location	GET /dictionaries/regions
city, location	GET /dictionaries/localities?region_code=…&q=…

Code
# Сектор и гео из справочников
curl -sS "https://app.strokka.com/api/v1/dictionaries/sectors"
curl -sS "https://app.strokka.com/api/v1/dictionaries/regions"

curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "filter[sector][contains][and]=Информационные технологии" \
  --data-urlencode "filter[region][eq][and]=Саратовская область" \
  --data-urlencode "filter[city][eq][and]=г. Балаково" \
  --data-urlencode "limit=20"

Подробнее — Справочники.

Оператор	Описание	Пример значения
contains	Содержит подстроку	IT
not_contains	Не содержит подстроку	тест
starts_with	Начинается с	ООО
ends_with	Заканчивается на	.ru
eq	Равно (точное совпадение)	Москва
neq	Не равно	Москва
in	Одно из (через запятую)	Москва,Санкт-Петербург
empty	Пустое значение	true
not_empty	Не пустое значение	true

Булевы поля

view · browser_check · dns_check · http_check

Оператор	Описание	Пример значения
eq	Равно	true
neq	Не равно	false
in	Одно из	true,false
empty	Пустое	true
not_empty	Не пустое	true

Поле id (целое число)

Оператор	Описание	Пример значения
eq	Равно	42
neq	Не равно	1
in	Одно из	1,2,3,4,5
gt	Больше	100
gte	Больше или равно	100
lt	Меньше	500
lte	Меньше или равно	500
between	Диапазон (через запятую)	100,500
empty	Пустое	true
not_empty	Не пустое	true

Поле updated_at (временна́я метка)

Оператор	Описание	Пример значения
eq	Равно	2026-01-01
neq	Не равно	2026-01-01
gt	Позже	2026-01-01
gte	Позже или равно	2026-01-01
lt	Раньше	2026-04-01
lte	Раньше или равно	2026-04-01
between	Диапазон	2026-01-01,2026-04-01
empty	Пустое	true
not_empty	Не пустое	true

Логические условия (AND/OR)

При использовании нескольких фильтров можно задать логику связи с предыдущим правилом:

• and — условие объединяется с предыдущим через логическое И (по умолчанию)
• or — условие объединяется с предыдущим через логическое ИЛИ

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

GET: Компании в Москве с активным DNS

Code
curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "searchMode=sql" \
  --data-urlencode "filter[city][eq][and]=Москва" \
  --data-urlencode "filter[dns_check][eq][and]=true" \
  --data-urlencode "limit=20"

GET: Несколько городов

Code
curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "filter[city][in][and]=Москва,Санкт-Петербург" \
  --data-urlencode "limit=20"

GET: Обновлённые за квартал

Code
curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "filter[updated_at][between][and]=2026-01-01,2026-06-01" \
  --data-urlencode "limit=50"

GET: Компании без email

Code
curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "filter[email][empty][and]=true" \
  --data-urlencode "limit=10"

GET: Поиск + фильтры (hybrid + город + email)

Code
curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "search=маркетинговое агентство" \
  --data-urlencode "searchMode=hybrid" \
  --data-urlencode "filter[city][eq][and]=Москва" \
  --data-urlencode "filter[email][not_empty][and]=true" \
  --data-urlencode "limit=10"

GET: Диапазон ID

Code
curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "filter[id][between][and]=1000,5000" \
  --data-urlencode "limit=100"

POST: Веб-студии с email

Code
curl -sS -X POST "https://app.strokka.com/api/v1/companies" \
  -H "Content-Type: application/json" \
  -d '{
    "search": "веб-студия",
    "searchMode": "hybrid",
    "limit": 10,
    "filters": [
      {"field": "email", "operator": "not_empty", "value": "true", "logic": "and"}
    ]
  }'

POST: Сортировка по ID, только с телефоном

Code
curl -sS -X POST "https://app.strokka.com/api/v1/companies" \
  -H "Content-Type: application/json" \
  -d '{
    "searchMode": "sql",
    "sortBy": "id",
    "sortOrder": "desc",
    "limit": 50,
    "filters": [
      {"field": "phone", "operator": "not_empty", "value": "true", "logic": "and"}
    ]
  }'

POST: Москва ИЛИ Санкт-Петербург (OR)

Code
curl -sS -X POST "https://app.strokka.com/api/v1/companies" \
  -H "Content-Type: application/json" \
  -d '{
    "searchMode": "sql",
    "limit": 20,
    "filters": [
      {"field": "city", "operator": "eq", "value": "Москва"},
      {"field": "city", "operator": "eq", "value": "Санкт-Петербург", "logic": "or"}
    ]
  }'

POST: Сложная комбинация (поиск + регион + WhatsApp)

Code
curl -sS -X POST "https://app.strokka.com/api/v1/companies" \
  -H "Content-Type: application/json" \
  -d '{
    "search": "логистика",
    "searchMode": "hybrid",
    "limit": 30,
    "filters": [
      {"field": "region", "operator": "contains", "value": "Москов", "logic": "and"},
      {"field": "whatsapp", "operator": "not_empty", "value": "true", "logic": "and"}
    ]
  }'

Фильтр по whatsapp сработает (appliedFilters в ответе, totalCount уменьшится), но в режиме hybrid колонка whatsapp в карточках не появится автоматически — API подставляет набор полей по смыслу запроса (columnProjection: inferred), обычно email и phone, без мессенджеров.

Чтобы получить whatsapp в ответе — передайте параметр columns:

Code
curl -sS -X POST "https://app.strokka.com/api/v1/companies" \
  -H "Content-Type: application/json" \
  -d '{
    "search": "логистика",
    "searchMode": "hybrid",
    "limit": 30,
    "columns": ["name", "email", "phone", "whatsapp"],
    "filters": [
      {"field": "region", "operator": "contains", "value": "Москов", "logic": "and"},
      {"field": "whatsapp", "operator": "not_empty", "value": "true", "logic": "and"}
    ]
  }'

В ответе: columnProjection: "explicit", в companies[] — только запрошенные поля + id и relevance. Пошаговый сценарий — Hybrid + filters + columns.

Полный WhatsApp без маски — только через экспорт.

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

Code
curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "search=производство" \
  --data-urlencode "searchMode=hybrid" \
  --data-urlencode "filter[email][not_empty][and]=true" \
  --data-urlencode "limit=1"

В ответе смотрите totalCount. Минимальный limit — 1.

Сводная таблица примеров

Задача	Метод	Параметры
Первые 10 компаний	GET	?searchMode=sql&limit=10
Hybrid-поиск	GET	?search=...&searchMode=hybrid
Москва + email	GET	filter[city][eq][and]=Москва&filter[email][not_empty][and]=true
Несколько городов	GET	filter[city][in][and]=Москва,СПб
Диапазон ID	GET	filter[id][between][and]=100,500
Поиск + фильтры	POST	search + filters[]
Hybrid + фильтры + нужные поля	POST	search + filters[] + columns[] — см. пример
Уникальные email/телефоны	GET/POST	uniqueBy=email или uniqueBy=email,phone — см. Поиск
Секторы, регионы, города	GET	/dictionaries/sectors, /dictionaries/regions, /dictionaries/localities — см. Справочники
Сколько найдено	GET/POST	limit=1 → totalCount в ответе

Пошаговые сценарии — в разделе Примеры. Справочник операторов — ниже на этой странице.

Больше примеров фильтрации — Фильтрация выборки.