X Lead Finder

GET/v1/x/leads

MCPx_leads3 creditsLive

Updated Oct 13, 2026

Description

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.

Parameters

Name	In	Type	Required	Default	Description
`q`	query	string	yes		Your product category or the problem it solves, e.g. crm or cold email. 1-60 characters.
`competitors`	query	string or array	no		Up to 5 tools people might switch away from, e.g. hubspot,pipedrive.
`exclude`	query	string or array	no		Up to 10 words that disqualify an item.
`time`	query	enum	no	`month`	How far back to look. One of: `day`, `week`, `month`, `year`.
`minScore`	query	number	no	`0.3`	Minimum intent score from 0 to 1. Range 0 to 1.
`intents`	query	string or array	no		Which intents to return. Default: all three.
`cursor`	query	string	no		Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.
`lang`	query	string	no	`en`	Tweet language, 2 letters.

q query, string, required: Your product category or the problem it solves, e.g. crm or cold email. 1-60 characters.
competitors query, string or array: Up to 5 tools people might switch away from, e.g. hubspot,pipedrive.
exclude query, string or array: Up to 10 words that disqualify an item.
time query, enum: How far back to look. One of: day, week, month, year. Default month.
minScore query, number: Minimum intent score from 0 to 1. Range 0 to 1. Default 0.3.
intents query, string or array: Which intents to return. Default: all three.
cursor query, string: Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.
lang query, string: Tweet language, 2 letters. Default en.

Request examples

curl "https://chatterapi.com/v1/x/leads?q=crm&time=year&minScore=0.3" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"

Response

data is a list of Lead, with page.nextCursor and page.hasMore for the next page. Fields:

Field	Type	Nullable	Description
`platform`	enum	no	reddit or x.
`kind`	enum	no	post, comment or tweet.
`id`	string	no	Platform id.
`url`	string	no	Full URL on the platform.
`text`	string	no	Text.
`author`	string	yes	Author username, null when deleted.
`authorUrl`	string	yes	Author profile URL.
`community`	string	yes	Subreddit for Reddit items, null for X.
`score`	number	yes	Score (upvotes minus downvotes) as Reddit reports it.
`createdAt`	string	yes	ISO 8601 UTC timestamp.
`intent`	enum	no	asking_for_recommendation, comparing_tools, complaining_about_tool or other.
`intentScore`	number	no	Intent score from 0 to 1.
`matchedTerms`	string[]	no	Phrases that made this a lead.

response

{
  "data": [
    {
      "platform": "x",
      "kind": "tweet",
      "id": "1714670799494230401",
      "url": "https://x.com/HCareAdvisorGuy/status/1714670799494230401",
      "text": "Looking for a CRM recommendation that would sync up with outlook (or is just easy to manage).  Or if you just feel really passionate about a specific CRM - send it my way.  Thanks in advance!",
      "author": "HCareAdvisorGuy",
      "authorUrl": "https://x.com/HCareAdvisorGuy",
      "community": null,
      "score": 1,
      "createdAt": "2023-10-18T15:52:30.000Z",
      "intent": "asking_for_recommendation",
      "intentScore": 0.68,
      "matchedTerms": [
        "looking for a",
        "looking for",
        "recommendation"
      ]
    },
    {
      "platform": "x",
      "kind": "tweet",
      "id": "1421773603981299713",
      "url": "https://x.com/StartupCheckr/status/1421773603981299713",
      "text": "For anyone looking for a CRM recommendation, you can check out https://t.co/2Ka9dOxQVN\n😃\n\n#CRM #bizbubble",
      "author": "StartupCheckr",
      "authorUrl": "https://x.com/StartupCheckr",
      "community": null,
      "score": 5,
      "createdAt": "2021-08-01T10:03:37.000Z",
      "intent": "asking_for_recommendation",
      "intentScore": 0.68,
      "matchedTerms": [
        "looking for a",
        "looking for",
        "recommendation"
      ]
    },
    {
      "platform": "x",
      "kind": "tweet",
      "id": "1198718907865030657",
      "url": "https://x.com/etiennexyz/status/1198718907865030657",
      "text": "💬 @EricFriedman asked: What is the best personal CRM?\n\nHi @rrhoover would you still recommend @airtable ? 👀\n\nCheck out Airtable: https://t.co/LnOLcPXrHf",
      "author": "etiennexyz",
      "authorUrl": "https://x.com/etiennexyz",
      "community": null,
      "score": 2,
      "createdAt": "2019-11-24T21:43:53.000Z",
      "intent": "asking_for_recommendation",
      "intentScore": 0.5,
      "matchedTerms": [
        "what is the best"
      ]
    }
  ],
  "page": {
    "nextCursor": "eyJ2IjoxLCJwIjoiZ2V0eGFwaSIsImMiOiJEQUFEREFBQkNnQUJIU0xuNGNqWFlCb0tBQUlRb3JSLTROYmdBUUFJQUFJQUFBQUNDQUFEQUFBQUFBZ0FCQUFBQUFBS0FBVWRTSDR4d3NBbkVBb0FCaDFJZmpIQ3Y5andDd0FIQUFBQThFVnRVRU0yZDBGQlFXWlJMMmRIU2s0d2RrZHdMMEZCUVVGQ1VWUjFlV1ZRVjBaVlVVRlNhR0l3WTJoMlZqSkNRVVpPVmtKNFFuZFlSVUZCV1VGT1dUQnFUbVYzVEhobVRIWkJTRzFzY2tkQ1NFWkxiM1Z2YVdGWlV6UlNVbHBFUzJKT1dVRkJVbFZVWmpobVJ6RklRVUZJUXpCT2VETllZVmxLTkZFNFdtNVRSVlpsZDBGQ1JFdzVTVkpYYkRsQlFVVm5WaTlOVlVWWGEwRkJWMHh1YkhkamFGbG5RVUpEYVhSSU4yY3hkVUZDUld4blQyMWtVVlZaUVVsVGMxTjNaa2hDWkdkQmVISjBkakF6UlZjNVEzRklVMHh1TkdOcVdGbENiMU5DVWpaTWNuUm1VVUZvYUdOUFRUaE9NakpJVFFBQSIsIm8iOjAsImgiOiIxMTMxODhkZmNkMTEifQ",
    "hasMore": true
  },
  "credits": {
    "charged": 3,
    "remaining": 24997
  },
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
  "cached": false
}

Recorded live response captured 2026-10-13, truncated to 3 items. Credits and request id are illustrative.

Credits

3 credits per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 10 minutes are served from cache.

Errors this tool can return

Try it

Try in the playground Run it free without signup