Search Leads
lead_searchRead-onlyIdempotent
Search and filter the lead pipeline by free-text query, status, score range, source, tags, and date. Get paginated results with total count for exports, scoring, and dashboards.
Instructions
Search and filter the lead pipeline. Optional filters: query (free-text over name/email/company), status ("new"|"qualified"|"disqualified"|"contacted"|"converted"), min_score, max_score, source, tags (array), date_from/date_to. Pagination via limit (default 50, max 200) and offset. Returns {total, leads[]}. Use this to drive exports, targeted scoring, and dashboards.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Case-insensitive substring search over email, first_name, last_name, job_title, and company.name. AND-combined with the other filters. | |
| status | No | Restrict to a single status: new (just ingested), enriched (lead_enrich done), scored (has score), qualified (score ≥ threshold), disqualified, exported, archived. | |
| min_score | No | Inclusive lower bound on score (0–100). Combine with status="qualified" for high-priority follow-up lists. | |
| max_score | No | Inclusive upper bound on score (0–100). Useful for review queues — e.g. min_score=40, max_score=60 to surface borderline leads. | |
| source | No | Filter to a single source channel. | |
| tags | No | Tags that must ALL be present on the lead (AND semantics). Empty array is ignored. | |
| limit | No | Page size, 1–100. Defaults to 20. | |
| offset | No | Number of results to skip for pagination. Defaults to 0. |