Фильтры

Операторы, поля и логика AND/OR для GET и POST.

На этой странице

Фильтрация по 30+ полям. Канонические значения сектора, технологий, региона и города — в справочниках.

Формат

GET

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

логика — and / or; у первого условия не используется
Несколько условий — повторите параметр

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": [
    {"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

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

Для sector, tech, region, city, location берите filterValue из справочника.

Технологии (стек сайта)

Поля tech и tech_category. В карточке стек приходит колонкой tech_stack, не полями фильтра.

`tech`

Значение — точный filterValue (WordPress, Yandex Metrica, 1C-Bitrix).

Оператор	Смысл
`eq` / `contains`	Точное вхождение в массив, не подстрока
`in`	Хотя бы одна из списка
`empty` / `not_empty`	Нет / есть стек

curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "searchMode=sql" \
  --data-urlencode "filter[tech][eq][and]=WordPress" \
  --data-urlencode "columns=name,domain,tech_stack" \
  --data-urlencode "limit=20"

Несколько через ИЛИ: filter[tech][in][and]=WordPress,Tilda,1C-Bitrix. Через И — повторите фильтр eq.

`tech_category`

Значение — categories[].id (слаг), не русская подпись label. Примеры: cms_and_site_builders, analytics, crm.

curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "searchMode=sql" \
  --data-urlencode "filter[tech_category][eq][and]=cms_and_site_builders" \
  --data-urlencode "limit=20"

Булевы поля

view · browser_check · dns_check · http_check

`id` и `updated_at`

Для id: eq, neq, in, gt, gte, lt, lte, between, empty, not_empty.

Для updated_at те же операторы сравнения. Значение — дата ISO 8601: 2026-01-01 или 2026-01-01T00:00:00. between — через запятую: 2026-01-01,2026-04-01.

AND / OR

and — по умолчанию, пересечение с предыдущим условием
or — объединение с предыдущим

logic первого фильтра игнорируется.

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"}
    ]
  }'

Примеры

Город + email + hybrid:

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"

Оценка объёма перед экспортом — limit=1, смотрите totalCount.

Пошаговые сценарии — Фильтрация выборки и Hybrid + columns.