curl --request GET \
--url https://api.trytikt.com/v1/leads/counts \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.trytikt.com/v1/leads/counts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.trytikt.com/v1/leads/counts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.trytikt.com/v1/leads/counts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.trytikt.com/v1/leads/counts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.trytikt.com/v1/leads/counts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.trytikt.com/v1/leads/counts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"at_threshold": 123,
"by_score": {
"0": 123,
"1": 123,
"2": 123,
"3": 123,
"4": 123,
"5": 123
},
"by_fit_band": {
"strong": 123,
"good": 123,
"weak": 123,
"excluded": 123
},
"discarded": 123
}{
"error": {
"code": "parametre_inconnu",
"message": "<string>",
"status": 123,
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "parametre_inconnu",
"message": "<string>",
"status": 123,
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "parametre_inconnu",
"message": "<string>",
"status": 123,
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "parametre_inconnu",
"message": "<string>",
"status": 123,
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "parametre_inconnu",
"message": "<string>",
"status": 123,
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "parametre_inconnu",
"message": "<string>",
"status": 123,
"request_id": "<string>",
"details": {}
}
}Count leads
How many leads match the same filters as GET /v1/leads: at your threshold, by score from 0 to 5, by band, and discarded. With q, counted over the first 1,001 matches.
curl --request GET \
--url https://api.trytikt.com/v1/leads/counts \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.trytikt.com/v1/leads/counts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.trytikt.com/v1/leads/counts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.trytikt.com/v1/leads/counts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.trytikt.com/v1/leads/counts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.trytikt.com/v1/leads/counts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.trytikt.com/v1/leads/counts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"at_threshold": 123,
"by_score": {
"0": 123,
"1": 123,
"2": 123,
"3": 123,
"4": 123,
"5": 123
},
"by_fit_band": {
"strong": 123,
"good": 123,
"weak": 123,
"excluded": 123
},
"discarded": 123
}{
"error": {
"code": "parametre_inconnu",
"message": "<string>",
"status": 123,
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "parametre_inconnu",
"message": "<string>",
"status": 123,
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "parametre_inconnu",
"message": "<string>",
"status": 123,
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "parametre_inconnu",
"message": "<string>",
"status": 123,
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "parametre_inconnu",
"message": "<string>",
"status": 123,
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "parametre_inconnu",
"message": "<string>",
"status": 123,
"request_id": "<string>",
"details": {}
}
}Authorizations
Your API key, created in Settings › API: Authorization: Bearer tikt_live_….
Query Parameters
Only leads scoring at least this, from 0 to 5. Your workspace's threshold by default (none inside a list).
^[0-5]$Only leads scoring at most this, from 0 to 5.
^[0-5]$true to include the leads you discarded and the ones your ICP excluded.
true, false Only these bands, separated by commas: strong, good, weak, excluded.
200Only leads that meet all these criteria, separated by commas: job_role, location, company_type, company_size, industry.
200Only leads that don't meet any of these criteria, separated by commas.
200Only the leads of this list. Inside a list, no threshold and discarded leads included, unless you ask.
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$true: only leads in at least one list; false: only leads in none.
true, false The same as in_list: a lead in a list counts as handled.
true, false Only leads who engaged with a post of this tracked profile.
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Only leads who engaged with this post.
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Only leads who reacted (reactions), commented (comments), or either (any).
reactions, comments, any Only leads with at least this many engagements.
^\d{1,3}$Only leads found or active since this date (ISO 8601).
40Only leads found or active over the last 24h, 7d or 30d.
24h, 7d, 30d Only leads found from this date on (ISO 8601).
40Only leads found before this date (ISO 8601).
40Only leads discarded or restored since this date (ISO 8601).
40Search the name, title, headline and company name. Counts stop at 1,001.
1 - 100