Skip to main content
GET
Count leads

Authorizations

Authorization
string
header
required

Your API key, created in Settings › API: Authorization: Bearer tikt_live_….

Query Parameters

min_score
string

Only leads scoring at least this, from 0 to 5. Your workspace's threshold by default (none inside a list).

Pattern: ^[0-5]$
max_score
string

Only leads scoring at most this, from 0 to 5.

Pattern: ^[0-5]$
include_discarded
enum<string>

true to include the leads you discarded and the ones your ICP excluded.

Available options:
true,
false
fit_band
string

Only these bands, separated by commas: strong, good, weak, excluded.

Maximum string length: 200
criteria_met
string

Only leads that meet all these criteria, separated by commas: job_role, location, company_type, company_size, industry.

Maximum string length: 200
criteria_not_met
string

Only leads that don't meet any of these criteria, separated by commas.

Maximum string length: 200
list_id
string

Only the leads of this list. Inside a list, no threshold and discarded leads included, unless you ask.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
in_list
enum<string>

true: only leads in at least one list; false: only leads in none.

Available options:
true,
false
handled
enum<string>

The same as in_list: a lead in a list counts as handled.

Available options:
true,
false
kol_id
string

Only leads who engaged with a post of this tracked profile.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
post_id
string

Only leads who engaged with this post.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
engaged_by
enum<string>

Only leads who reacted (reactions), commented (comments), or either (any).

Available options:
reactions,
comments,
any
min_engagements
string

Only leads with at least this many engagements.

Pattern: ^\d{1,3}$
engaged_since
string

Only leads found or active since this date (ISO 8601).

Maximum string length: 40
engaged_within
enum<string>

Only leads found or active over the last 24h, 7d or 30d.

Available options:
24h,
7d,
30d
first_seen_after
string

Only leads found from this date on (ISO 8601).

Maximum string length: 40
first_seen_before
string

Only leads found before this date (ISO 8601).

Maximum string length: 40
status_changed_after
string

Only leads discarded or restored since this date (ISO 8601).

Maximum string length: 40
q
string

Search the name, title, headline and company name. Counts stop at 1,001.

Required string length: 1 - 100

Response

Success.

at_threshold
integer
required
by_score
object
required
by_fit_band
object
required
discarded
integer
required