---
title: "Find Reddit buying-intent leads"
method: GET
path: "/reddit/leads"
tags: ["Reddit"]
---

# Find Reddit buying-intent leads

`GET /reddit/leads`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/reddit/leads`
- Auth: API key in header `x-api-key`

Scans a Reddit search page for people actively asking for a product or service, scores each post 0-10 for buying intent, and returns them ranked highest-first with the signals that fired. Self-promotion, hiring posts, freelancer service adverts, revenue-milestone posts, duplicate reposts, and Title Case article headlines are filtered out before scoring. A deterministic prefilter always runs; when `classifier` resolves to `llm` the surviving candidates are additionally refined in one batched model call. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. The lead-response fields and credit weights are preserved regardless of the underlying Reddit data source.

## Query parameters

- `q` string, required
- `subreddit` string
- `sort` 'relevance' | 'hot' | 'new' | 'top' | 'comments'
- `time` 'hour' | 'day' | 'week' | 'month' | 'year' | 'all'
- `limit` integer
- `min_score` integer
- `classifier` 'auto' | 'heuristic' | 'llm'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- RedditLeadsResponseDoc
  - `code` integer
  - `data` RedditleadsResponse
    - `classifier` string
    - `degraded` boolean
    - `leads` RedditleadsLead[]
      - `author` string
      - `comment_count` integer
      - `created` string
      - `permalink` string
      - `post_score` integer
      - `reason` string
      - `score` integer
      - `signals` RedditleadsSignal[]
        - `id` string
        - `label` string
      - `subreddit` string
      - `title` string
    - `min_score` integer
    - `model` string
    - `query` string
    - `stats` RedditleadsStats
      - `classified` integer
      - `prefiltered` integer
      - `returned` integer
      - `scanned` integer
    - `subreddit` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

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