Компании

Поиск компаний

GET

https://app.strokka.com/api/v1

/v1/companies

Поиск компаний › query Parameters

skip

integer · min: 0

Смещение пагинации

Default: 0

limit

integer · min: 1 · max: 1000

Размер страницы

Default: 100

skipCount

boolean

Не считать totalCount (для лендинга: total берётся из /companies/stats)

Default: false

search

Текст для поиска

sortBy

Поле сортировки

sortOrder

Порядок сортировки

Default: asc

searchMode

string · enum

Режим поиска

Enum values:

auto

vector

fts

hybrid

sql

entity

Default: auto

columns

Явный список полей в ответе (name, email, phone, whatsapp, …). Повторите параметр или передайте через запятую.

uniqueBy

Дедупликация по контактным полям (email, phone). Повторите параметр или передайте через запятую.

relevanceThreshold

Минимальный порог схожести в Qdrant (0–1). Выше — строже отбор, ниже — шире выдача. По умолчанию 0.8.

Поиск компаний › Headers

x-user-id

ID пользователя

X-Previous-Semantic

Semantic предыдущего запроса (уточнение колонок)

X-Previous-Display-Fields

Колонки предыдущей таблицы через запятую

Поиск компаний › Responses

Successful Response

Ответ постраничного поиска или списка компаний.

SearchResponse

object[] · required

Запрошенная страница записей

totalCount

integer · required

Общее число записей, попадающих под условие

skip

integer · required

Текущее смещение

limit

integer · required

Размер страницы

searchMode

string · required

Режим: sql, vector, fts, hybrid, entity

object · required

Время этапов обработки, сек.

ColumnMeta[]

Метаданные колонок для UI (порядок и подписи).

Нормализованный текст поискового запроса (если был передан параметр search)

sortingMode

string · enum

Где применяется sortBy: server (SQL), fixed (релевантность), client.

Enum values:

server

client

fixed

Default: server

cached

boolean

Были ли использованы кэшированные данные

Default: false

Список модулей, запрошенных/выбранных для ответа в auto-режиме.

Поля JSON в ответе после compile (колонки таблицы).

Режим проекции колонок: explicit, inferred, minimal.

Интент: catalog (полный список по фильтрам), discovery (тема), entity.

Краткое объяснение, как система поняла запрос (auto-режим).

AppliedFilterMeta[]

Фильтры, реально применённые к запросу (в т.ч. от LLM в auto).

Поля дедупликации, применённые к выдаче (email, phone).

GET/v1/companies

curl https://app.strokka.com/api/v1/v1/companies

Example Responses

{
  "companies": [
    {}
  ],
  "columns": [
    {
      "key": "key",
      "label": "label",
      "type": "text",
      "filterable": false,
      "sortable": false,
      "serverSortable": false,
      "width": 0
    }
  ],
  "totalCount": 0,
  "skip": 0,
  "limit": 0,
  "normalized_query": "string",
  "searchMode": "searchMode",
  "sortingMode": "server",
  "timing": {
    "key": 0
  },
  "cached": false,
  "modules": [
    "string"
  ],
  "displayFields": [
    "string"
  ],
  "columnProjection": "string",
  "queryType": "string",
  "intentSummary": "string",
  "appliedFilters": [
    {
      "field": "field",
      "operator": "operator",
      "value": ""
    }
  ],
  "uniqueBy": [
    "string"
  ]
}

json

application/json

Поиск компаний (POST)

POST

https://app.strokka.com/api/v1

/v1/companies

Поиск компаний (POST) › Headers

x-user-id

ID пользователя

Поиск компаний (POST) › Request Body

Аналог GET /companies, но параметры передаются в JSON-теле.

CompanySearchRequest

Текст для семантического / полнотекстового поиска. Если не задан — режим SQL.

skip

integer · min: 0

Смещение пагинации.

Default: 0

limit

integer · min: 1 · max: 1000

Размер страницы (максимум 1000).

Default: 100

Поле сортировки (только SQL): id, domain, name, sector, region, city, employees_range.

sortOrder

string

Порядок: asc или desc.

Default: asc

FilterRule[]

Массив правил фильтрации.

searchMode

string · enum

Режим поиска: auto, vector, fts, hybrid, sql, entity.

Enum values:

auto

vector

fts

hybrid

sql

entity

Default: auto

Semantic предыдущего запроса (уточнение таблицы).

Колонки предыдущей таблицы при уточнении («добавь телеграм»).

Минимальный порог схожести в Qdrant (0–1). Выше — строже отбор, ниже — шире выдача. По умолчанию 0.8.

Явный список полей в ответе (name, email, phone, whatsapp, …). Если не задан — используются значения по умолчанию.

Дедупликация по контактным полям: email, phone. Пустые значения не участвуют; повтор по любому полю отсекается.

Поиск компаний (POST) › Responses

Successful Response

Ответ постраничного поиска или списка компаний.

SearchResponse

object[] · required

Запрошенная страница записей

totalCount

integer · required

Общее число записей, попадающих под условие

skip

integer · required

Текущее смещение

limit

integer · required

Размер страницы

searchMode

string · required

Режим: sql, vector, fts, hybrid, entity

object · required

Время этапов обработки, сек.

ColumnMeta[]

Метаданные колонок для UI (порядок и подписи).

Нормализованный текст поискового запроса (если был передан параметр search)

sortingMode

string · enum

Где применяется sortBy: server (SQL), fixed (релевантность), client.

Enum values:

server

client

fixed

Default: server

cached

boolean

Были ли использованы кэшированные данные

Default: false

Список модулей, запрошенных/выбранных для ответа в auto-режиме.

Поля JSON в ответе после compile (колонки таблицы).

Режим проекции колонок: explicit, inferred, minimal.

Интент: catalog (полный список по фильтрам), discovery (тема), entity.

Краткое объяснение, как система поняла запрос (auto-режим).

AppliedFilterMeta[]

Фильтры, реально применённые к запросу (в т.ч. от LLM в auto).

Поля дедупликации, применённые к выдаче (email, phone).

POST/v1/companies

curl https://app.strokka.com/api/v1/v1/companies \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "columns": [
    "name",
    "email",
    "phone",
    "whatsapp"
  ],
  "filters": [
    {
      "field": "email",
      "operator": "not_empty",
      "value": "true"
    }
  ],
  "limit": 10,
  "search": "веб-студия",
  "searchMode": "hybrid"
}'

Example Request Body

{
  "columns": [
    "name",
    "email",
    "phone",
    "whatsapp"
  ],
  "filters": [
    {
      "field": "email",
      "operator": "not_empty",
      "value": "true"
    }
  ],
  "limit": 10,
  "search": "веб-студия",
  "searchMode": "hybrid"
}

json

Example Responses

{
  "companies": [
    {}
  ],
  "columns": [
    {
      "key": "key",
      "label": "label",
      "type": "text",
      "filterable": false,
      "sortable": false,
      "serverSortable": false,
      "width": 0
    }
  ],
  "totalCount": 0,
  "skip": 0,
  "limit": 0,
  "normalized_query": "string",
  "searchMode": "searchMode",
  "sortingMode": "server",
  "timing": {
    "key": 0
  },
  "cached": false,
  "modules": [
    "string"
  ],
  "displayFields": [
    "string"
  ],
  "columnProjection": "string",
  "queryType": "string",
  "intentSummary": "string",
  "appliedFilters": [
    {
      "field": "field",
      "operator": "operator",
      "value": ""
    }
  ],
  "uniqueBy": [
    "string"
  ]
}

json

application/json

Экспорт компаний

POST

https://app.strokka.com/api/v1

/v1/companies/export

Возвращает список компаний с контактами без маскировки и списывает кредиты подписки владельца API-ключа.

Тело (JSON): companyIds (массив id, не пустой), key (secretKey), exclude (необязательно) — домены для исключения (кредиты за них не списываются).

Кредиты списываются только за фактически найденные компании. При нехватке баланса — 402, если ничего не найдено — 404 (без списания).

Подробности: docs.strokka.com/export.

Экспорт компаний › Headers

x-user-id

Экспорт компаний › Responses

Successful Response

No data returned

· Компании

Поиск компаний

GET

https://app.strokka.com/api/v1

/v1/companies

Поиск компаний › query Parameters

skip

integer · min: 0

Смещение пагинации

Default: 0

limit

integer · min: 1 · max: 1000

Размер страницы

Default: 100

skipCount

boolean

Не считать totalCount (для лендинга: total берётся из /companies/stats)

Default: false

search

Текст для поиска

sortBy

Поле сортировки

sortOrder

Порядок сортировки

Default: asc

searchMode

string · enum

Режим поиска

Enum values:

auto

vector

fts

hybrid

sql

entity

Default: auto

columns

Явный список полей в ответе (name, email, phone, whatsapp, …). Повторите параметр или передайте через запятую.

uniqueBy

Дедупликация по контактным полям (email, phone). Повторите параметр или передайте через запятую.

relevanceThreshold

Минимальный порог схожести в Qdrant (0–1). Выше — строже отбор, ниже — шире выдача. По умолчанию 0.8.

Поиск компаний › Headers

x-user-id

ID пользователя

X-Previous-Semantic

Semantic предыдущего запроса (уточнение колонок)

X-Previous-Display-Fields

Колонки предыдущей таблицы через запятую

Поиск компаний › Responses

Successful Response

Ответ постраничного поиска или списка компаний.

SearchResponse

object[] · required

Запрошенная страница записей

totalCount

integer · required

Общее число записей, попадающих под условие

skip

integer · required

Текущее смещение

limit

integer · required

Размер страницы

searchMode

string · required

Режим: sql, vector, fts, hybrid, entity

object · required

Время этапов обработки, сек.

ColumnMeta[]

Метаданные колонок для UI (порядок и подписи).

Нормализованный текст поискового запроса (если был передан параметр search)

sortingMode

string · enum

Где применяется sortBy: server (SQL), fixed (релевантность), client.

Enum values:

server

client

fixed

Default: server

cached

boolean

Были ли использованы кэшированные данные

Default: false

Список модулей, запрошенных/выбранных для ответа в auto-режиме.

Поля JSON в ответе после compile (колонки таблицы).

Режим проекции колонок: explicit, inferred, minimal.

Интент: catalog (полный список по фильтрам), discovery (тема), entity.

Краткое объяснение, как система поняла запрос (auto-режим).

AppliedFilterMeta[]

Фильтры, реально применённые к запросу (в т.ч. от LLM в auto).

Поля дедупликации, применённые к выдаче (email, phone).

Поиск компаний (POST)

POST

https://app.strokka.com/api/v1

/v1/companies

Поиск компаний (POST) › Headers

x-user-id

ID пользователя

Поиск компаний (POST) › Request Body

Аналог GET /companies, но параметры передаются в JSON-теле.

CompanySearchRequest

Текст для семантического / полнотекстового поиска. Если не задан — режим SQL.

skip

integer · min: 0

Смещение пагинации.

Default: 0

limit

integer · min: 1 · max: 1000

Размер страницы (максимум 1000).

Default: 100

Поле сортировки (только SQL): id, domain, name, sector, region, city, employees_range.

sortOrder

string

Порядок: asc или desc.

Default: asc

FilterRule[]

Массив правил фильтрации.

searchMode

string · enum

Режим поиска: auto, vector, fts, hybrid, sql, entity.

Enum values:

auto

vector

fts

hybrid

sql

entity

Default: auto

Semantic предыдущего запроса (уточнение таблицы).

Колонки предыдущей таблицы при уточнении («добавь телеграм»).

Минимальный порог схожести в Qdrant (0–1). Выше — строже отбор, ниже — шире выдача. По умолчанию 0.8.

Явный список полей в ответе (name, email, phone, whatsapp, …). Если не задан — используются значения по умолчанию.

Дедупликация по контактным полям: email, phone. Пустые значения не участвуют; повтор по любому полю отсекается.

Поиск компаний (POST) › Responses

Successful Response

Ответ постраничного поиска или списка компаний.

SearchResponse

object[] · required

Запрошенная страница записей

totalCount

integer · required

Общее число записей, попадающих под условие

skip

integer · required

Текущее смещение

limit

integer · required

Размер страницы

searchMode

string · required

Режим: sql, vector, fts, hybrid, entity

object · required

Время этапов обработки, сек.

ColumnMeta[]

Метаданные колонок для UI (порядок и подписи).

Нормализованный текст поискового запроса (если был передан параметр search)

sortingMode

string · enum

Где применяется sortBy: server (SQL), fixed (релевантность), client.

Enum values:

server

client

fixed

Default: server

cached

boolean

Были ли использованы кэшированные данные

Default: false

Список модулей, запрошенных/выбранных для ответа в auto-режиме.

Поля JSON в ответе после compile (колонки таблицы).

Режим проекции колонок: explicit, inferred, minimal.

Интент: catalog (полный список по фильтрам), discovery (тема), entity.

Краткое объяснение, как система поняла запрос (auto-режим).

AppliedFilterMeta[]

Фильтры, реально применённые к запросу (в т.ч. от LLM в auto).

Поля дедупликации, применённые к выдаче (email, phone).

Экспорт компаний

POST

https://app.strokka.com/api/v1

/v1/companies/export

Возвращает список компаний с контактами без маскировки и списывает кредиты подписки владельца API-ключа.

Подробности: docs.strokka.com/export.

Экспорт компаний › Headers

x-user-id

Экспорт компаний › Responses

Successful Response

No data returned