Tools reference
Leads & pipelines tools
Query your leads database, pipelines, projects, and stats.
search_leads
leads:readSearch your Linkeddit leads database for Reddit users identified as potential leads based on buying intent, niche, and engagement scores.
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | yes | Search query to match against username, bio, niches, tags, or industry | |
| subreddit | yes | Filter by target subreddit | |
| status | yes | Filter by lead status | |
| min_score | yes | Minimum contactability score (0-100) | |
| limit | yes | Max results |
get_user_profile
leads:readGet a detailed Reddit user profile from the Linkeddit database including karma, post/comment counts, niches, tags, and contactability score.
| Parameter | Type | Required | Description |
|---|---|---|---|
| username | yes | Reddit username to look up |
get_user_posts
leads:readGet Reddit posts by a specific user from the Linkeddit database.
| Parameter | Type | Required | Description |
|---|---|---|---|
| username | yes | Reddit username | |
| subreddit | yes | Filter posts by subreddit | |
| limit | yes | Max results |
get_user_comments
leads:readGet Reddit comments by a specific user from the Linkeddit database.
| Parameter | Type | Required | Description |
|---|---|---|---|
| username | yes | Reddit username | |
| subreddit | yes | Filter comments by subreddit | |
| limit | yes | Max results |
get_lead_insights
leads:readGet AI-generated insights about a Reddit user including their expertise level, niches, tags, and a description derived from their Reddit activity.
| Parameter | Type | Required | Description |
|---|---|---|---|
| username | yes | Reddit username to get insights for |
list_pipelines
leads:readList your Linkeddit lead-gen pipelines (search requests) with their current processing status.
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | yes | Max results |
get_pipeline_results
leads:readGet a specific lead-gen pipeline's request details and result records (status + result file).
| Parameter | Type | Required | Description |
|---|---|---|---|
| request_id | yes | The pipeline (user_request) id |
get_lead_stats
leads:readAggregate stats across your leads: counts by status and reach-out status, and average contactability score.
list_projects
leads:readList your Linkeddit lead projects (product overview, goals, audience, brand voice) used to personalize outreach.
create_lead_pipeline
leads:writeuses quotaCreate and queue a new lead-generation pipeline. Linkeddit scrapes and scores Reddit users (or review-site reviewers) matching your keywords, then writes them to your leads database. Consumes your execution quota; runs asynchronously (poll with get_pipeline_results).
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | yes | A name for this pipeline | |
| purpose | yes | What you are looking for / the product context | |
| keywords | yes | Search keywords (1-50) | |
| source | yes | Lead source: reddit (needs exactly 1 subreddit) or review_sites | |
| subreddit | yes | Target subreddit (required for reddit source) | |
| competitors | yes | Competitor names (review_sites source) | |
| target_urls | yes | Review URLs (review_sites source) | |
| category | yes | Optional category | |
| duration | yes | Look-back window for posts/reviews |