Примеры

Фильтрация выборки

Фильтры сужают выборку по 30+ полям: город, отрасль, наличие контактов, диапазоны дат и ID. Справочник операторов — в разделе Фильтры. Канонические значения сектора, региона и города — в Справочниках (filterValue из ответа API).

Сценарий 1: IT-компании в Москве с email

Задача: список компаний из IT-сектора в Москве, у которых заполнен email.

Метод: GET с фильтрами в query string, режим sql (без текстового поиска, можно сортировать).

Сценарий 2: Производство в Подмосковье с телефоном

Задача: текстовый поиск «производство» + фильтры по региону и наличию телефона.

Метод: POST с JSON — удобнее, когда много условий или не хочется кодировать скобки в URL.

Code
curl -sS -X POST "https://app.strokka.com/api/v1/companies" \
  -H "Content-Type: application/json" \
  -d '{
    "search": "производство",
    "searchMode": "hybrid",
    "limit": 50,
    "filters": [
      {"field": "region", "operator": "eq", "value": "Московская область", "logic": "and"},
      {"field": "phone", "operator": "not_empty", "value": "true", "logic": "and"}
    ]
  }'

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

Задача: понять, сколько компаний попадёт в выборку и сколько кредитов понадобится.

Сценарий 4: Москва ИЛИ Санкт-Петербург

Задача: компании в одном из двух городов (логика 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"}
    ]
  }'

Второе условие с "logic": "or" объединяется с первым через ИЛИ.

Когда GET, когда POST

Ситуация	Рекомендация
1–3 простых фильтра	GET с --data-urlencode для каждого filter[...]
Много фильтров, OR-логика	POST — читаемый JSON
Текстовый поиск + фильтры	Оба работают; POST удобнее для сложных filters[]

Что дальше?

• Поиск и первый экспорт — экспорт отфильтрованной выборки
• Фильтры — полный список полей и операторов
• Примеры запросов — все сценарии