# 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/uk/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/uk/pricing)
- [API](https://klinio.io/uk/developers)
- [MCP-сервер](https://klinio.io/uk/developers/mcp)
- [Збір email із Google Карт](https://klinio.io/uk/google-maps-email-extractor)
- [Пошук email на сайті](https://klinio.io/uk/website-email-finder)
- [Збір email із пошуку Google](https://klinio.io/uk/google-search-email-extractor)
- [Збір email із Clutch](https://klinio.io/uk/clutch-email-extractor)
- [Пошук компаній у LinkedIn](https://klinio.io/uk/linkedin-company-email-finder)
- [Конфіденційність розширення](https://klinio.io/uk/extension-privacy)

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