# Klinio artık kendi kodunuzda.

Sitedeki aramaların aynısını başlatın, geçmişinizi listeleyin ve şirketleri JSON olarak alın. API hesabınızın kredilerini kullanır; günlük ücretsiz krediler de dahil.

- Taban URL: https://klinio.io/api/v1
- OpenAPI 3.1: https://klinio.io/openapi.json
- MCP sunucusu: https://klinio.io/api/mcp (https://klinio.io/tr/developers/mcp)
- Access for AI agents: https://klinio.io/auth.md

## Hızlı başlangıç

1. Ne ve nerede (query ve location) ile ya da Klinio'nun okuduğu bir bağlantıyla arama başlatın: Google ya da Google Haritalar araması, Clutch dizini veya şirket web siteleri.
2. Durumunu kontrol edin. Çoğu arama birkaç dakikada biter; şirketler bulundukça gelir.
3. Şirketleri okuyun: web sitesi, e-postalar ve telefonlar.

```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"

```

## Uç noktalar

Anahtarınızı Authorization başlığında Bearer kl_live_… olarak, istek gövdesini JSON olarak gönderin. Her yanıt JSON'dur.

- `POST /searches`: Arama başlatır. query ve location (ne ve nerede: Google Haritalar araması) ya da link (bir arama bağlantısı ya da web siteleri) veya websites (liste) gönderin. İsterseniz limit (1-500 şirket) ve country (iki harf, google.com arama bağlantısı için) ekleyin.
- `GET /searches`: Geçmişiniz: sitede, eklentide ya da API ile başlatılan bütün aramalar, en yenisi önce. source, status, origin, q, since ve until ile süzebilirsiniz.
- `GET /searches/{id}`: Tek bir arama: durumu ve şimdiye kadar kaç şirket bulduğu.
- `GET /searches/{id}/results`: Bulduğu şirketler, 100'er 100'er (limit en fazla 500). only=contacts yalnızca e-postası ya da telefonu olanları bırakır; next_cursor sonraki sayfayı getirir.
- `DELETE /searches/{id}`: Sırada bekleyen ya da süren bir aramayı durdurur. Bulduklarına dokunulmaz.
- `GET /account`: Planınız ve kalan kredileriniz.

## Geçmişiniz de API'de.

Sitede, Chrome eklentisinde ya da API ile başlattığınız her arama aynı geçmişte toplanır. Listeleyin, süzün ve herhangi bir aramanın şirketlerini results_url adresinden okuyun.

- `source`: Aramanın yapıldığı yer. linkedin_list eklentiden gönderilen bir LinkedIn listesi, websites bir web siteleri listesi, merged ise sitede birleştirdiğiniz listelerdir.
- `status`: Aramanın durumu. Her birinin anlamı aşağıda.
- `origin`: Nerede başlattığınız: klinio.io'da, Chrome eklentisinde ya da API ile.
- `q`: Aramanın adında ya da sözcüklerinde geçen metin. Büyük-küçük harf ve Türkçe karakter fark etmez: sisli, Şişli'yi de bulur.
- `since`, `until`: Aramanın başladığı zamana göre: since o andan itibaren, until o ana kadar. Bir tarih (2026-11-01) ya da ISO 8601 zamanı gönderin; until'deki tarih o günü de kapsar.
- `limit`, `cursor`: Sayfa başına 1-100 arama (belirtmezseniz 20). Sonraki sayfa için next_cursor değerini cursor olarak gönderin; total, süzgeçlere uyan bütün aramaları sayar.

## Bir aramanın durumu

- `queued`: Sırasını bekliyor.
- `running`: Şirketleri buluyor ve sitelerini okuyor.
- `completed`: Bitti. Her şirket kontrol edildi.
- `stopped`: Sizin tarafınızdan durduruldu. Bulduklarına dokunulmadı.
- `failed`: Tamamlanamadı. Nedeni failure alanında.

## Krediler ve sınırlar

- Bir kredi, e-postası ya da telefonu bulunan bir şirkettir; sitedekiyle aynı. Hiçbir şey bulunamayan şirketler ücretsizdir.
- Ücretsiz hesap günlük kredilerini, paket ise bakiyesini kullanır. Kredi kalmadıysa yeni arama 402 döner.
- Hesap başına aynı anda en fazla 3 arama sırada ya da sürüyor olabilir; anahtar başına dakikada 120 istek.
- API tarayıcıdan çağrılamaz: CORS başlığı göndermez, böylece anahtar sunucunuzda kalır.

## Hatalar

Hata, HTTP durum koduyla ve bir JSON gövdesiyle döner: error.code ve error.message.

- `unauthorized`: Anahtar yok, yanlış ya da iptal edilmiş.
- `insufficient_credits`: Yeni bir arama için kredi kalmadı.
- `invalid_request`: Gövde ya da bir parametre geçersiz.
- `invalid_link`: Klinio bu bağlantıyı okumuyor.
- `mixed_input`: Aynı istekte bir arama bağlantısı ve web siteleri.
- `unsupported_google_tab`: Şirket listelemeyen bir Google sekmesi, Görseller ya da Haberler gibi.
- `source_disabled`: Bu site şu an kapalı.
- `too_many_running`: Aynı anda sırada ya da süren çok fazla arama var.
- `rate_limited`: Bu dakika içinde çok fazla istek.
- `not_found`: Bu hesapta böyle bir arama yok.
- `not_running`: Arama ne sırada ne de sürüyor.

- [Fiyatlar](https://klinio.io/tr/pricing)
- [API](https://klinio.io/tr/developers)
- [MCP sunucusu](https://klinio.io/tr/developers/mcp)
- [Google Haritalar e-posta bulucu](https://klinio.io/tr/google-maps-email-extractor)
- [Web sitesinden e-posta bulucu](https://klinio.io/tr/website-email-finder)
- [Google aramadan e-posta bulucu](https://klinio.io/tr/google-search-email-extractor)
- [Clutch e-posta bulucu](https://klinio.io/tr/clutch-email-extractor)
- [LinkedIn şirket bulucu](https://klinio.io/tr/linkedin-company-email-finder)
- [Eklenti gizliliği](https://klinio.io/tr/extension-privacy)

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