# Klinio, depuis votre propre code.

Lancez les mêmes recherches que sur le site, consultez votre historique et récupérez les entreprises en JSON. L’API utilise les crédits de votre compte, y compris les crédits quotidiens gratuits.

- URL de base: https://klinio.io/api/v1
- OpenAPI 3.1: https://klinio.io/openapi.json
- Serveur MCP: https://klinio.io/api/mcp (https://klinio.io/fr/developers/mcp)
- Access for AI agents: https://klinio.io/auth.md

## Démarrage rapide

1. Lancez une recherche avec quoi et où (query et location), ou avec un lien que Klinio sait lire : une recherche Google ou Google Maps, un annuaire Clutch ou des sites d’entreprises.
2. Suivez-la. La plupart des recherches se terminent en quelques minutes ; les entreprises apparaissent au fur et à mesure.
3. Lisez les entreprises : site web, e-mails et téléphones.

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

```

## Points d’accès

Envoyez votre clé dans l’en-tête Authorization sous la forme Bearer kl_live_…, et les corps de requête en JSON. Chaque réponse est en JSON.

- `POST /searches`: Lance une recherche. Envoyez query et location (quoi et où : une recherche Google Maps), ou link (un lien de recherche, ou des sites), ou websites (une liste). En option, limit (de 1 à 500 entreprises) et country (deux lettres, pour un lien de recherche google.com).
- `GET /searches`: Votre historique : chaque recherche lancée sur le site, dans l’extension ou avec l’API, de la plus récente à la plus ancienne. Filtrez-le avec source, status, origin, q, since et until.
- `GET /searches/{id}`: Une recherche : son statut et le nombre d’entreprises trouvées jusqu’ici.
- `GET /searches/{id}/results`: Les entreprises trouvées, 100 à la fois (limit jusqu’à 500). only=contacts garde celles qui ont un e-mail ou un téléphone ; next_cursor donne la page suivante.
- `DELETE /searches/{id}`: Arrête une recherche en attente ou en cours. Ce qu’elle a trouvé reste.
- `GET /account`: Votre offre et les crédits qu’il vous reste.

## Votre historique est aussi dans l’API.

Chaque recherche lancée sur le site, dans l’extension Chrome ou avec l’API rejoint le même historique. Listez-le, filtrez-le et lisez les entreprises de n’importe quelle recherche via son results_url.

- `source`: Où la recherche a été faite. linkedin_list est une liste LinkedIn envoyée depuis l’extension, websites une liste de sites web, merged des listes fusionnées sur le site.
- `status`: Où en est la recherche. Chaque statut est expliqué plus bas.
- `origin`: Où vous l’avez lancée : sur klinio.io, dans l’extension Chrome ou avec l’API.
- `q`: Un texte du nom ou des mots de la recherche. Majuscules et accents ne comptent pas : cafe trouve aussi Café.
- `since`, `until`: Selon le début de la recherche : since à partir de ce moment, until jusqu’à lui. Envoyez une date (2026-11-01) ou une heure ISO 8601 ; une date dans until inclut toute la journée.
- `limit`, `cursor`: De 1 à 100 recherches par page (20 par défaut). Renvoyez next_cursor dans cursor pour la page suivante ; total compte toutes les recherches qui correspondent.

## Le statut d’une recherche

- `queued`: Attend son tour.
- `running`: Trouve des entreprises et lit leurs sites.
- `completed`: Terminée. Chaque entreprise a été vérifiée.
- `stopped`: Arrêtée par vous. Ce qu’elle a trouvé reste.
- `failed`: N’a pas pu aboutir. failure en donne la raison.

## Crédits et limites

- Un crédit correspond à une entreprise avec un e-mail ou un téléphone, comme sur le site. Les entreprises sans résultat ne coûtent rien.
- Un compte gratuit utilise ses crédits quotidiens, un pack son solde. Sans crédit, une nouvelle recherche répond 402.
- Jusqu’à 3 recherches en attente ou en cours en même temps par compte, et 120 requêtes par minute et par clé.
- Un navigateur ne peut pas appeler l’API : elle n’envoie aucun en-tête CORS, la clé reste donc sur votre serveur.

## Erreurs

Une erreur répond avec son statut HTTP et un corps JSON : error.code et error.message.

- `unauthorized`: La clé manque, est fausse ou révoquée.
- `insufficient_credits`: Plus de crédits pour une nouvelle recherche.
- `invalid_request`: Le corps ou un paramètre n’est pas valide.
- `invalid_link`: Klinio ne lit pas ce lien.
- `mixed_input`: Un lien de recherche et des sites dans la même requête.
- `unsupported_google_tab`: Un onglet Google qui ne liste pas d’entreprises, comme Images ou Actualités.
- `source_disabled`: Ce site est désactivé pour le moment.
- `too_many_running`: Trop de recherches en attente ou en cours en même temps.
- `rate_limited`: Trop de requêtes cette minute.
- `not_found`: Aucune recherche de ce type sur ce compte.
- `not_running`: La recherche n’est ni en attente ni en cours.

- [Tarifs](https://klinio.io/fr/pricing)
- [API](https://klinio.io/fr/developers)
- [Serveur MCP](https://klinio.io/fr/developers/mcp)
- [Extracteur d’e-mails Google Maps](https://klinio.io/fr/google-maps-email-extractor)
- [Recherche d’e-mails sur un site](https://klinio.io/fr/website-email-finder)
- [Extracteur d’e-mails pour Google](https://klinio.io/fr/google-search-email-extractor)
- [Extracteur d’e-mails Clutch](https://klinio.io/fr/clutch-email-extractor)
- [Recherche d’entreprises LinkedIn](https://klinio.io/fr/linkedin-company-email-finder)
- [Confidentialité de l’extension](https://klinio.io/fr/extension-privacy)

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