Klinio, from your own code.
Start the same searches as on the site, list your history and read the companies as JSON. The API spends your account's credits, the free daily ones included.
https://klinio.io/api/v1Your API keys
A key acts as your account. Keep it on your server, never in a web page or an app.
- 1Start a search with what and where (query and location), or with any link Klinio reads: a Google or Google Maps search, a Clutch directory, or company websites.
- 2Check on it. Most searches finish within a few minutes; companies appear as they are found.
- 3Read the companies: website, emails and phones.
# 1. Start a search
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}'
# 2. Check on it (status: queued, running, completed)
curl https://klinio.io/api/v1/searches/SEARCH_ID \
-H "Authorization: Bearer $KLINIO_KEY"
# 3. Read the companies with an email or phone
curl "https://klinio.io/api/v1/searches/SEARCH_ID/results?only=contacts" \
-H "Authorization: Bearer $KLINIO_KEY"Your history is in the API too.
Every search you start on the site, in the Chrome extension or with the API goes into one history. List it, filter it, and read any search’s companies at its results_url.
source- Where the search ran. linkedin_list is a LinkedIn list sent from the extension, websites a list of websites, merged lists you joined on the site.
google_mapsgoogle_searchclutchlinkedinlinkedin_listwebsitesmerged status- Where the search stands. Each status is explained below.
queuedrunningcompletedstoppedfailed origin- Where you started it: on klinio.io, in the Chrome extension or with the API.
siteextensionapi q- Text in the search’s name or words. Capitals and accents don’t matter: cafe also finds Café.
sinceuntil- By when the search started: since from that moment, until up to it. Send a date (2026-11-01) or an ISO 8601 time; a date in until includes that whole day.
limitcursor- 1 to 100 searches a page (20 if you don’t say). Send next_cursor back as cursor for the next page; total counts every search that matches.
# Your whole history, newest first: site, extension and API
curl "https://klinio.io/api/v1/searches?limit=100" \
-H "Authorization: Bearer $KLINIO_KEY"
# Finished Google Maps searches since 1 November
curl -G https://klinio.io/api/v1/searches \
-d source=google_maps -d status=completed -d since=2026-11-01 \
-H "Authorization: Bearer $KLINIO_KEY"
# Searches with "agency" in their name
curl -G https://klinio.io/api/v1/searches -d q=agency \
-H "Authorization: Bearer $KLINIO_KEY"{
"data": [{
"id": "8f2d41c7-3b9e-4c55-a1d0-6e7b2c9f0a13",
"status": "completed",
"source": "google_search",
"query": "web design agency ankara",
"link": "https://www.google.com/search?q=web+design+agency+ankara&gl=tr",
"limit": 100,
"origin": "site",
"created_at": "2026-11-07T10:19:07.805Z",
"finished_at": "2026-11-07T10:31:42.118Z",
"companies": { "found": 71, "with_contacts": 65, "checking": 0 },
"failure": null,
"results_url": "/api/v1/searches/8f2d41c7-3b9e-4c55-a1d0-6e7b2c9f0a13/results"
}],
"total": 61,
"next_cursor": "WyIyMDI2LTExLTA3IDEwOjE5OjA3Ljgw…"
}Endpoints
Send your key in the Authorization header as Bearer kl_live_…, and JSON in request bodies. Every answer is JSON.
- POST
/searchesStart a search. Send query and location (what and where: a Google Maps search), or link (a search link, or websites), or websites (a list). Optionally limit (1 to 500 companies) and country (two letters, for a google.com search link).
- GET
/searchesYour history: every search started on the site, in the extension or with the API, newest first. Filter it with source, status, origin, q, since and until.
- GET
/searches/{id}One search: its status and how many companies it has found.
- GET
/searches/{id}/resultsThe companies it found, 100 at a time (limit up to 500). only=contacts keeps those with an email or phone; next_cursor brings the next page.
- DELETE
/searches/{id}Stop a queued or running search. What it found stays.
- GET
/accountYour plan and the credits you have left.
{
"id": "1c5c9560-8174-4745-88e0-5682394d69cd",
"status": "running",
"source": "google_maps",
"query": "web design agencies in Ankara",
"link": "https://www.google.com/maps/search/web+design+agencies+in+Ankara/",
"limit": 50,
"origin": "api",
"created_at": "2026-11-07T15:58:23.257Z",
"finished_at": null,
"companies": { "found": 18, "with_contacts": 14, "checking": 4 },
"failure": null,
"results_url": "/api/v1/searches/1c5c9560-8174-4745-88e0-5682394d69cd/results"
}{
"search_status": "completed",
"data": [{
"id": "b0a3e7c2-5d4f-4a8e-9c61-2f7d8e1a4b90",
"company": "Bilgeweb Interactive",
"website": "https://www.bilgeweb.com.tr",
"emails": ["info@bilgeweb.com.tr"],
"phones": ["+90 312 911 75 02"],
"location": "Yenimahalle/Ankara, Türkiye",
"industry": "Advertising agency",
"source": "google_maps",
"status": "done",
"created_at": "2026-11-07T15:58:31.904Z"
}],
"next_cursor": null
}A search's status
queuedWaiting for its turn.runningFinding companies and reading their sites.completedDone. Every company has been checked.stoppedStopped by you. What it found stays.failedCould not finish. failure says why.
Credits and limits
- One credit is one company with an email or phone, as on the site. Companies with nothing found cost nothing.
- A free account spends its daily credits; a pack spends its balance. With no credits left, a new search answers 402.
- Up to 3 searches queued or running at once per account, and 120 requests a minute per key.
- Browsers can't call the API: it sends no CORS headers, so a key stays on your server.
Errors
An error answers with its HTTP status and a JSON body: error.code and error.message.
- 400
invalid_requestThe body or a parameter isn't valid. - 400
invalid_linkKlinio doesn't read that link. - 400
mixed_inputA search link and websites in one request. - 400
unsupported_google_tabA Google tab that lists no companies, like Images or News. - 401
unauthorizedThe key is missing, wrong or revoked. - 402
insufficient_creditsNo credits left for a new search. - 403
source_disabledThat site is switched off for now. - 404
not_foundNo such search on this account. - 409
not_runningThe search isn't queued or running. - 429
too_many_runningToo many searches queued or running at once. - 429
rate_limitedToo many requests this minute.