leads

Query leads

Transport: call this endpoint with HTTP GET and query parameters. Query the global leads database with filters for headline, source, qualification status, email, replies and intent. If you will draft or stage outbound copy from returned leads, call library_context_get next and apply the returned Outreach template plus Brand context before writing.

get/v1/leads/query

Request

  • Base URL: https://api.zevari.ai
  • URL: https://api.zevari.ai/v1/leads/query
  • Auth: HTTP bearer

Query parameters

keywordstring

Deprecated: matched a field that is no longer stored; a non-empty value returns no rows. Use search or headline_filter.

headline_filterstring

Case-insensitive search on headline

source'comments' | 'dms' | 'intent' | 'search'

Filter by where the lead came from: a LinkedIn comment, a LinkedIn message (or any reply), a buying signal / own-post engagement (or a marked intent), or a LinkedIn / saved search

has_emailboolean

Filter leads that have email

has_intentboolean

Filter leads with intent signals

has_ever_repliedboolean

Filter leads by whether they have ever replied

has_active_campaign_targetboolean

Filter leads by active pending or in-progress campaign target membership

quiet_since_daysinteger

Return open leads that replied before this many days ago, with no newer outbound reply

qualification'qualified' | 'unqualified'

Filter by qualification

searchstring

Free text search across name and headline

limitnumber

Max results

offsetnumber

Pagination offset

Response

Successful Zevari API response.

okboolean required

False when the underlying tool reports an error or a partial failure.

methodstring required

Public API method name.

dataunknown required
request_idstring required

Request correlation ID. Also returned in X-Zevari-Request-Id.

Example response

{
  "method": "campaigns.delete"
}

Changes

No recorded changes to this operation across all 1 revision of this API.