Skip to Content
APIComment leads

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

NameTypeRequiredNotes
cursorstringno1–1024 chars — opaque pagination cursor from a previous page; an invalid cursor answers 404
matched_keywordstring | string[]norepeatable OR-set, lead surface only
min_scorestringnominimum relevance score: 50, 60, 70 or 80
page_sizestringnodefaults to 10, capped at 100; malformed values fall back to the default
prioritystringnoat most 32 chars — plain string (≤32 chars) compared against the lead’s priority
source_typestringnolead (default) or competitor — selects the surface
trigger_competitorstringnoat most 64 chars — competitor surface only; one owned competitor id
workflowstringnonew (default: the 24-hour untouched window), saved, replied, or all

Responses

200OKapplication/json

FieldTypeRequiredNotes
nextstring | nullyes
previousstring | nullyes
resultsobject[]yes
idstringyes
project_idstringyes
relevance_scorestring | nullyes
prioritystringyes
is_savedbooleanyes
is_repliedbooleanyes
match_reasonstringyes
source_typestringyes
trigger_keyword_idstring | nullyes
matched_keywordstring | nullyes
created_atstringyes
updated_atstringyes
reddit_commentobjectyes
comment_fullnamestringyes
post_titlestringyes
subreddit_name_prefixedstringyes
authorstringyes
bodystringyes
permalinkstringyes
created_utcstring | nullyes
{ "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.

Last updated on