---
title: "Lead Finder"
method: GET
path: "/v1/leads"
tags: ["everywhere"]
---

# Lead Finder

`GET /v1/leads`

## Request

- Base URL: `https://chatterapi.com`
- URL: `https://chatterapi.com/v1/leads`
- Auth: HTTP bearer

Find people on Reddit and X who are asking for a recommendation, comparing tools or complaining about one in your category, ranked by an intent score from 0 to 1 with the phrases that matched. Costs 6 credits per page (4 if only one platform answers). Tip: start with your category in two or three words and add up to five competitors. Costs up to 6 credits.

## Query parameters

- `q` string, required
- `competitors` union
  - string
  - string[]
- `exclude` union
  - string
  - string[]
- `time` 'day' | 'week' | 'month' | 'year'
- `minScore` number
- `intents` union
  - string
  - string[]
- `cursor` string
- `subreddit` string
- `lang` string

## Response `200`

Success

- object
  - `data` Lead[], required
    - `platform` 'reddit' | 'x', required
    - `kind` 'post' | 'comment' | 'tweet', required
    - `id` string, required
    - `url` string, required
    - `text` string, required
    - `author` string, nullable, required
    - `authorUrl` string, nullable, required
    - `community` string, nullable, required
    - `score` number, nullable, required
    - `createdAt` string, nullable, required: ISO 8601 UTC timestamp
    - `intent` 'asking_for_recommendation' | 'comparing_tools' | 'complaining_about_tool' | 'other', required
    - `intentScore` number, required
    - `matchedTerms` string[], required
  - `page` PageInfo
    - `nextCursor` string, nullable, required
    - `hasMore` boolean, required
  - `credits` Credits, required
    - `charged` integer, required
    - `remaining` integer, required
  - `requestId` string, required
  - `cached` boolean, required
  - `warnings` Warning[]
    - `code` 'partial_data' | 'stale_data' | 'platform_unavailable' | 'source_unavailable', required
    - `platform` 'reddit' | 'x'
    - `source` string
    - `fields` string[]

## Other responses

- `400`: Bad request: invalid_input
- `401`: Unauthorized: missing_key, invalid_key, key_revoked
- `402`: Payment required: insufficient_credits
- `403`: Forbidden: account_suspended, scope_denied
- `404`: Not found: not_found
- `429`: Too many requests: rate_limited
- `500`: Internal error: internal
- `502`: Bad gateway: upstream_error
- `504`: Gateway timeout: upstream_timeout

---

[API](https://skmtc.dev/chatterapi/apis/chatterapi-api.md) · [All operations](https://skmtc.dev/chatterapi/apis/chatterapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatterapi/apis/chatterapi-api/revisions/74036d6f908a?raw)