Comment leads
Read ordinary and competitor comment leads. Use the project’s id as
{projectId}. Each result includes reddit_comment with the comment body,
author, permalink and parent post title. The title is empty when the parent
post is unavailable.
List comment leads
GET/api/v1/projects/{projectId}/comment-leads/
Query parameters
| Name | Type | Required | Notes |
|---|---|---|---|
cursor | string | no | 1–1024 chars — opaque pagination cursor from a previous page; an invalid cursor answers 404 |
matched_keyword | string | string[] | no | repeatable OR-set, lead surface only |
min_score | string | no | minimum relevance score: 50, 60, 70 or 80 |
page_size | string | no | defaults to 10, capped at 100; malformed values fall back to the default |
priority | string | no | at most 32 chars — plain string (≤32 chars) compared against the lead’s priority |
source_type | string | no | lead (default) or competitor — selects the surface |
trigger_competitor | string | no | at most 64 chars — competitor surface only; one owned competitor id |
workflow | string | no | new (default: the 24-hour untouched window), saved, replied, or all |
Responses
200OKapplication/json
| Field | Type | Required | Notes |
|---|---|---|---|
next | string | null | yes | |
previous | string | null | yes | |
results | object[] | yes | |
id | string | yes | |
project_id | string | yes | |
relevance_score | string | null | yes | |
priority | string | yes | |
is_saved | boolean | yes | |
is_replied | boolean | yes | |
match_reason | string | yes | |
source_type | string | yes | |
trigger_keyword_id | string | null | yes | |
matched_keyword | string | null | yes | |
created_at | string | yes | |
updated_at | string | yes | |
reddit_comment | object | yes | |
comment_fullname | string | yes | |
post_title | string | yes | |
subreddit_name_prefixed | string | yes | |
author | string | yes | |
body | string | yes | |
permalink | string | yes | |
created_utc | string | null | yes |
{
"next": null,
"previous": null,
"results": [
{
"id": "7f8e9d0c-4444-4b5a-8e7f-6a5b4c3d2e1f",
"project_id": "b1a2c3d4-0000-4a5b-8c6d-7e8f9a0b1c2d",
"relevance_score": "80",
"priority": "high",
"is_saved": false,
"is_replied": false,
"match_reason": "Matched keyword \"notion template\" (exact).",
"source_type": "lead",
"trigger_keyword_id": "3c2b1a0d-1111-4e5f-8a9b-0c1d2e3f4a5b",
"matched_keyword": "notion template",
"created_at": "2026-11-18T08:15:00.000000+00:00",
"updated_at": "2026-11-18T08:15:00.000000+00:00",
"reddit_comment": {
"comment_fullname": "t1_example1",
"post_title": "How do you track freelance clients?",
"subreddit_name_prefixed": "r/Notion",
"author": "freelance_discussion",
"body": "Looking for a Notion template to track invoices and deadlines.",
"permalink": "https://www.reddit.com/r/Notion/comments/1example0/thread/example1/",
"created_utc": "2026-11-18T07:58:00+00:00"
}
}
]
}All errors answer the standard problem body — this operation can also return 400, 401, 404, 429, 5xx, documented in Errors & retries.
Ordinary and competitor comments
Read ordinary comments with source_type=lead (the default). Use
workflow=all to include older comments and those already acted on:
export INTENTLOOM_API_TOKEN='il_live_REPLACE_WITH_YOUR_TOKEN'
export INTENTLOOM_PROJECT='b1a2c3d4-0000-4a5b-8c6d-7e8f9a0b1c2d'
curl -fsS "https://api.intentloom.com/api/v1/projects/$INTENTLOOM_PROJECT/comment-leads/?workflow=all" \
-H "Authorization: Token $INTENTLOOM_API_TOKEN"For competitor comments, set source_type=competitor. Optionally select
one competitor using its id as trigger_competitor:
curl -fsS "https://api.intentloom.com/api/v1/projects/$INTENTLOOM_PROJECT/comment-leads/?source_type=competitor&trigger_competitor=COMPETITOR_ID&workflow=all" \
-H "Authorization: Token $INTENTLOOM_API_TOKEN"Filters and cursor pagination
work the same way as for post leads. Follow next as-is with the same
Token header; next: null ends the collection. The default workflow=new
returns only the recent 24-hour untouched window.