curl --request GET \
--url https://api.trytikt.com/v1/leads \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.trytikt.com/v1/leads"
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', 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",
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"
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")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.trytikt.com/v1/leads")
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{
"data": [
{
"id": "<string>",
"status": "<string>",
"score": 123,
"score_max": 123,
"fit_band": "<string>",
"criteria": [
{
"key": "<string>",
"label": "<string>",
"mode": "<string>",
"verdict": "<string>",
"justification": "<string>"
}
],
"disqualifiers": [
{
"kind": "<string>",
"key": "<string>",
"label": "<string>",
"justification": "<string>"
}
],
"summary": "<string>",
"scored_at": "<string>",
"scoring_version": "<string>",
"icp_version_id": "<string>",
"engagement_count": 123,
"reaction_count": 123,
"comment_count": 123,
"signals": [
{
"id": "<string>",
"kind": "<string>",
"reaction_type": "<string>",
"text": "<string>",
"url": "<string>",
"likes": 123,
"replies": 123,
"is_pinned": true,
"is_edited": true,
"occurred_at": "<string>",
"captured_at": "<string>",
"post": {
"id": "<string>",
"linkedin_post_id": "<string>",
"urn": "<string>",
"url": "<string>",
"author": {
"type": "<string>",
"name": "<string>",
"public_id": "<string>",
"linkedin_url": "<string>",
"avatar_url": "<string>"
},
"text": "<string>",
"hashtags": [
"<string>"
],
"media_type": "<string>",
"media": {
"images": [
"<string>"
],
"videos": [
"<string>"
]
},
"external_links": [
"<string>"
],
"is_repost": true,
"posted_at": "<string>",
"counters": {
"reactions": 123,
"comments": 123,
"checked_at": "<string>"
},
"tracking_status": "<string>",
"source": "<string>",
"kol": {
"id": "<string>",
"name": "<string>",
"relationship": "<string>",
"linkedin_url": "<string>"
},
"console_url": "<string>"
}
}
],
"first_seen_at": "<string>",
"last_engagement_at": "<string>",
"status_changed_at": "<string>",
"lists": [
{
"id": "<string>",
"name": "<string>",
"added_at": "<string>"
}
],
"handled": true,
"console_url": "<string>",
"person": {
"id": "<string>",
"linkedin_url": "<string>",
"linkedin_member_id": "<string>",
"full_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"headline": "<string>",
"about": "<string>",
"picture_url": "<string>",
"location": {
"country": "<string>",
"country_code": "<string>",
"region": "<string>",
"city": "<string>"
},
"current_position": {
"title": "<string>",
"company_name": "<string>",
"company_linkedin_url": "<string>"
},
"seniority": "<string>",
"department": "<string>",
"positions": [
{
"title": "<string>",
"company_name": "<string>",
"company_linkedin_url": "<string>",
"company_linkedin_id": "<string>",
"start_date": "<string>",
"end_date": "<string>",
"is_current": true,
"duration": "<string>",
"location": "<string>",
"employment_type": "<string>",
"workplace_type": "<string>",
"description": "<string>"
}
],
"education": [
{
"school_name": "<string>",
"school_linkedin_url": "<string>",
"degree": "<string>",
"field_of_study": "<string>",
"start_year": 123,
"end_year": 123
}
],
"languages": [
{
"name": "<string>",
"proficiency": "<string>"
}
],
"skills": [
"<string>"
],
"followers_count": 123,
"connections_count": 123,
"flags": {
"open_to_work": true,
"is_hiring": true,
"is_premium": true,
"is_influencer": true,
"is_verified": true,
"is_creator": true
},
"profile_language": "<string>",
"profile_country": "<string>",
"websites": [
"<string>"
],
"linkedin_member_since": "<string>",
"profile_read_at": "<string>"
},
"company": {
"id": "<string>",
"linkedin_company_id": "<string>",
"name": "<string>",
"universal_name": "<string>",
"linkedin_url": "<string>",
"website": "<string>",
"domain": "<string>",
"logo_url": "<string>",
"tagline": "<string>",
"about": "<string>",
"industry": "<string>",
"specialties": [
"<string>"
],
"company_size": "<string>",
"employees_count": 123,
"organization_type": "<string>",
"founded_year": 123,
"followers_count": 123,
"headquarters": "<string>",
"country_code": "<string>",
"locations": [
"<string>"
],
"enriched_at": "<string>"
}
}
],
"page": {
"next_cursor": "<string>",
"has_more": true
}
}{
"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": {}
}
}List leads
A page of leads with their full profile and their verdict criterion by criterion. Without filters, what the Leads page shows: leads at your workspace’s threshold, without the ones you discarded, newest first.
curl --request GET \
--url https://api.trytikt.com/v1/leads \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.trytikt.com/v1/leads"
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', 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",
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"
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")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.trytikt.com/v1/leads")
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{
"data": [
{
"id": "<string>",
"status": "<string>",
"score": 123,
"score_max": 123,
"fit_band": "<string>",
"criteria": [
{
"key": "<string>",
"label": "<string>",
"mode": "<string>",
"verdict": "<string>",
"justification": "<string>"
}
],
"disqualifiers": [
{
"kind": "<string>",
"key": "<string>",
"label": "<string>",
"justification": "<string>"
}
],
"summary": "<string>",
"scored_at": "<string>",
"scoring_version": "<string>",
"icp_version_id": "<string>",
"engagement_count": 123,
"reaction_count": 123,
"comment_count": 123,
"signals": [
{
"id": "<string>",
"kind": "<string>",
"reaction_type": "<string>",
"text": "<string>",
"url": "<string>",
"likes": 123,
"replies": 123,
"is_pinned": true,
"is_edited": true,
"occurred_at": "<string>",
"captured_at": "<string>",
"post": {
"id": "<string>",
"linkedin_post_id": "<string>",
"urn": "<string>",
"url": "<string>",
"author": {
"type": "<string>",
"name": "<string>",
"public_id": "<string>",
"linkedin_url": "<string>",
"avatar_url": "<string>"
},
"text": "<string>",
"hashtags": [
"<string>"
],
"media_type": "<string>",
"media": {
"images": [
"<string>"
],
"videos": [
"<string>"
]
},
"external_links": [
"<string>"
],
"is_repost": true,
"posted_at": "<string>",
"counters": {
"reactions": 123,
"comments": 123,
"checked_at": "<string>"
},
"tracking_status": "<string>",
"source": "<string>",
"kol": {
"id": "<string>",
"name": "<string>",
"relationship": "<string>",
"linkedin_url": "<string>"
},
"console_url": "<string>"
}
}
],
"first_seen_at": "<string>",
"last_engagement_at": "<string>",
"status_changed_at": "<string>",
"lists": [
{
"id": "<string>",
"name": "<string>",
"added_at": "<string>"
}
],
"handled": true,
"console_url": "<string>",
"person": {
"id": "<string>",
"linkedin_url": "<string>",
"linkedin_member_id": "<string>",
"full_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"headline": "<string>",
"about": "<string>",
"picture_url": "<string>",
"location": {
"country": "<string>",
"country_code": "<string>",
"region": "<string>",
"city": "<string>"
},
"current_position": {
"title": "<string>",
"company_name": "<string>",
"company_linkedin_url": "<string>"
},
"seniority": "<string>",
"department": "<string>",
"positions": [
{
"title": "<string>",
"company_name": "<string>",
"company_linkedin_url": "<string>",
"company_linkedin_id": "<string>",
"start_date": "<string>",
"end_date": "<string>",
"is_current": true,
"duration": "<string>",
"location": "<string>",
"employment_type": "<string>",
"workplace_type": "<string>",
"description": "<string>"
}
],
"education": [
{
"school_name": "<string>",
"school_linkedin_url": "<string>",
"degree": "<string>",
"field_of_study": "<string>",
"start_year": 123,
"end_year": 123
}
],
"languages": [
{
"name": "<string>",
"proficiency": "<string>"
}
],
"skills": [
"<string>"
],
"followers_count": 123,
"connections_count": 123,
"flags": {
"open_to_work": true,
"is_hiring": true,
"is_premium": true,
"is_influencer": true,
"is_verified": true,
"is_creator": true
},
"profile_language": "<string>",
"profile_country": "<string>",
"websites": [
"<string>"
],
"linkedin_member_since": "<string>",
"profile_read_at": "<string>"
},
"company": {
"id": "<string>",
"linkedin_company_id": "<string>",
"name": "<string>",
"universal_name": "<string>",
"linkedin_url": "<string>",
"website": "<string>",
"domain": "<string>",
"logo_url": "<string>",
"tagline": "<string>",
"about": "<string>",
"industry": "<string>",
"specialties": [
"<string>"
],
"company_size": "<string>",
"employees_count": 123,
"organization_type": "<string>",
"founded_year": 123,
"followers_count": 123,
"headquarters": "<string>",
"country_code": "<string>",
"locations": [
"<string>"
],
"enriched_at": "<string>"
}
}
],
"page": {
"next_cursor": "<string>",
"has_more": true
}
}{
"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 - 100first_seen_at (the default, newest first), score, engagements or last_engagement_at.
first_seen_at, score, engagements, last_engagement_at Items per page, from 1 to 100. 50 by default.
^\d{1,3}$The next_cursor of the previous page. Leave it out for the first page.
1 - 600