# Klinio прямо из вашего кода.

Запускайте те же поиски, что и на сайте, просматривайте историю и получайте компании в JSON. API расходует кредиты вашего аккаунта, включая бесплатные ежедневные.

- Базовый URL: https://klinio.io/api/v1
- OpenAPI 3.1: https://klinio.io/openapi.json
- MCP-сервер: https://klinio.io/api/mcp (https://klinio.io/ru/developers/mcp)
- Access for AI agents: https://klinio.io/auth.md

## Быстрый старт

1. Запустите поиск, указав что и где (query и location), или по ссылке, которую читает Klinio: поиск Google или Google Карт, каталог Clutch либо сайты компаний.
2. Проверяйте статус. Большинство поисков завершается за несколько минут; компании появляются по мере нахождения.
3. Получите компании: сайт, email и телефоны.

```bash

curl -X POST https://klinio.io/api/v1/searches \
  -H "Authorization: Bearer $KLINIO_KEY" -H "Content-Type: application/json" \
  -d '{"query": "web design agencies", "location": "Ankara", "limit": 50}'
curl https://klinio.io/api/v1/searches/SEARCH_ID -H "Authorization: Bearer $KLINIO_KEY"
curl "https://klinio.io/api/v1/searches/SEARCH_ID/results?only=contacts" -H "Authorization: Bearer $KLINIO_KEY"

```

## Эндпоинты

Передавайте ключ в заголовке Authorization как Bearer kl_live_…, а тела запросов в JSON. Каждый ответ приходит в JSON.

- `POST /searches`: Запускает поиск. Передайте query и location (что и где: поиск на Google Картах), либо link (ссылку на поиск или сайты), либо websites (список). По желанию limit (от 1 до 500 компаний) и country (две буквы, для ссылки на поиск google.com).
- `GET /searches`: Ваша история: все поиски, запущенные на сайте, в расширении или через API, сначала новые. Фильтры: source, status, origin, q, since и until.
- `GET /searches/{id}`: Один поиск: его статус и сколько компаний уже найдено.
- `GET /searches/{id}/results`: Найденные компании, по 100 за раз (limit до 500). only=contacts оставляет компании с email или телефоном; next_cursor даёт следующую страницу.
- `DELETE /searches/{id}`: Останавливает поиск в очереди или в работе. Найденное остаётся.
- `GET /account`: Ваш тариф и оставшиеся кредиты.

## Ваша история тоже есть в API.

Каждый поиск, запущенный на сайте, в расширении Chrome или через API, попадает в одну историю. Получайте её списком, фильтруйте и читайте компании любого поиска по его results_url.

- `source`: Источник поиска. linkedin_list: список LinkedIn из расширения; websites: список сайтов; merged: списки, объединённые на сайте.
- `status`: Состояние поиска. Что значит каждое, описано ниже.
- `origin`: Где вы его запустили: на klinio.io, в расширении Chrome или через API.
- `q`: Текст в названии или словах поиска. Регистр букв не важен.
- `since`, `until`: По времени начала поиска: since с этого момента, until до него. Передайте дату (2026-11-01) или время в ISO 8601; дата в until включает весь день.
- `limit`, `cursor`: От 1 до 100 поисков на странице (по умолчанию 20). Для следующей страницы передайте next_cursor в cursor; total считает все подходящие поиски.

## Статус поиска

- `queued`: Ждёт своей очереди.
- `running`: Находит компании и читает их сайты.
- `completed`: Готово. Все компании проверены.
- `stopped`: Остановлен вами. Найденное остаётся.
- `failed`: Не удалось завершить. Причину укажет поле failure.

## Кредиты и лимиты

- Один кредит означает одну компанию с email или телефоном, как на сайте. Компании, для которых ничего не нашлось, бесплатны.
- Бесплатный аккаунт тратит ежедневные кредиты, пакет тратит свой баланс. Без кредитов новый поиск отвечает 402.
- До 3 поисков в очереди или в работе одновременно на аккаунт и 120 запросов в минуту на ключ.
- Браузер не может вызвать API: оно не отправляет заголовки CORS, поэтому ключ остаётся на вашем сервере.

## Ошибки

Ошибка приходит с HTTP-статусом и телом JSON: error.code и error.message.

- `unauthorized`: Ключа нет, он неверный или отозван.
- `insufficient_credits`: Нет кредитов для нового поиска.
- `invalid_request`: Тело запроса или параметр недопустимы.
- `invalid_link`: Klinio не читает такую ссылку.
- `mixed_input`: Ссылка на поиск и сайты в одном запросе.
- `unsupported_google_tab`: Вкладка Google без списка компаний, например «Картинки» или «Новости».
- `source_disabled`: Этот сайт сейчас отключён.
- `too_many_running`: Слишком много поисков в очереди или в работе одновременно.
- `rate_limited`: Слишком много запросов за эту минуту.
- `not_found`: В этом аккаунте нет такого поиска.
- `not_running`: Поиск не в очереди и не в работе.

- [Цены](https://klinio.io/ru/pricing)
- [API](https://klinio.io/ru/developers)
- [MCP-сервер](https://klinio.io/ru/developers/mcp)
- [Сбор email из Google Карт](https://klinio.io/ru/google-maps-email-extractor)
- [Поиск email на сайте](https://klinio.io/ru/website-email-finder)
- [Сбор email из поиска Google](https://klinio.io/ru/google-search-email-extractor)
- [Сбор email из Clutch](https://klinio.io/ru/clutch-email-extractor)
- [Поиск компаний в LinkedIn](https://klinio.io/ru/linkedin-company-email-finder)
- [Конфиденциальность расширения](https://klinio.io/ru/extension-privacy)

---
Page: https://klinio.io/ru/developers
Markdown: https://klinio.io/ru/developers.md
