x

X Lead Finder

Find tweets where people ask for a recommendation, compare tools, or complain about a tool in your category. Returns leads ranked by an intent score (0 to 1) with the matched phrases and the author's handle. Costs 3 credits per page. Tip: pass competitors to catch people looking to switch. Costs 3 credits.

get/v1/x/leads

Request

  • Base URL: https://chatterapi.com
  • URL: https://chatterapi.com/v1/x/leads
  • Auth: HTTP bearer

Query parameters

qstring required

Your product category or the problem it solves, e.g. crm or cold email. 1-60 characters.

string
OR
string[]

Up to 5 tools people might switch away from, e.g. hubspot,pipedrive.

string
OR
string[]

Up to 10 words that disqualify an item.

time'day' | 'week' | 'month' | 'year'

How far back to look.

minScorenumber

Minimum intent score from 0 to 1.

string
OR
string[]

Which intents to return. Default: all three.

cursorstring

Opaque cursor from the previous response's page.nextCursor.

langstring

Tweet language, 2 letters.

Response

Success

requestIdstring required
cachedboolean required

Example response

{
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V"
}

Changes

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