How-to guide
How to find people ready to buy on Reddit
Call reddit/search with a product category as the query, label=intent and relevance=filter, and the response returns on-topic posts with a buying intent judgement under computed.labels. Each post links to the thread, so you can reply where the buyer already asked. A run costs 1 credit.
1 credit per run, in one API call
The calls, in order
Each step is one request to the SocialCrawl API. Copy the curl, add your key and run it.
Search Reddit posts
1 credit per callTry this call on its endpoint page: Search Reddit postscurlcurl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/reddit/search?query=best+crm+for+startups&label=intent&relevance=filter"
What comes back
A real response from reddit/search, captured from the SocialCrawl API, with long lists cut to two rows.
JSON
{
"success": true,
"platform": "reddit",
"endpoint": "/v1/reddit/search",
"data": {
"items": [
{
"post": {
"id": "1wrckhp",
"url": "https://www.reddit.com/r/ClaudeAI/comments/1wrckhp/what_tool_have_you_built_for_yourself_with_claude/",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": null,
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"username": "user_1c226d",
"display_name": "user_37da46",
"avatar_url": "https://example.com/avatars/user_246eb3.png",
"verified": null
},
"engagement": {
"views": null,
"likes": 1183,
"comments": 581,
"shares": null,
"saves": null
},
"flags": {
"nsfw": false,
"spoiler": false,
"pinned": null,
"deleted": false
},
"published_at": "2026-09-27T06:12:55.000Z",
"ext": {
"subreddit": "ClaudeAI",
"title": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"selftext": "I built a tool that reads emails from my kid’s school and other activities (swimming, music classes, scouts) etc and then: - Adds them to our shared calendar- Sends us a WhatsApp message to remind us the day before of what to pack in his school bag- Tells us what is on his lunch menu (helps us to avoid making the same dinner for him as he would have had for lunch) This all saves so much headache and head space in our daily routine. No more flapping around in the morning!!! I’ve also build tools that help with invoicing and proposals for example. Those have single-handedly removed a lot of daily frustration and friction. For example sometimes I wouldn’t bid on a job because I knew it would take a few hours of my day to write the proposal. And that would leave money on the table. Not it takes 5 mins and more work is coming in as a result simply because more proposals are going through the door. I’d I love to hear what you guys are making and things that really help you out. My main aim is to get my evenings and weekends back and be able to spend more time with my family whilst still scaling my business. Maybe they are lofty goals!!",
"upvote_ratio": 0.9750402576489532,
"flair": "Claude Code Workflow",
"content_language": "en",
"published_at_epoch": 1790489575
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "food",
"estimated_reach": null,
"relevance": {
"p": 0.95,
"sense": "target",
"depth": 1.52,
"spam": 0.18
},
"labels": {
"sponsored": {
"p": 0.04,
"disclosed": false,
"undisclosed": false,
"brand": null
},
"intent": {
"label": "other",
"confidence": 0.55,
"buyer": false,
"seller": 0.06,
"fits_offer": null,
"urgency": 0.4
},
"niche": {
"label": "technology",
"confidence": 0.89,
"taxonomy": "sc-niche-v1"
}
}
}
},
{
"post": {
"id": "1wqnn5x",
"url": "https://www.reddit.com/r/ClaudeAI/comments/1wqnn5x/claude_code_users_are_getting_up_to_250_in_free/",
"content": {
"text": "Sample comment text (redacted).",
"media_urls": "https://madrobot.blog/2026/09/24/claude-code-cloud-sessions-free-credit-how-to-claim/",
"thumbnail_url": "https://external-preview.redd.it/a5YzxKLxe6DjLWqf21T52VT5R2_j8clQxEGkWpNkADY.jpeg?auto=webp&s=c739062d30747aaa35f78bfb4348eff896509a17",
"duration_seconds": null
},
"author": {
"username": "user_15284e",
"display_name": "user_72b766",
"avatar_url": "https://example.com/avatars/user_d9b374.png",
"verified": null
},
"engagement": {
"views": null,
"likes": 110,
"comments": 53,
"shares": null,
"saves": null
},
"flags": {
"nsfw": false,
"spoiler": false,
"pinned": null,
"deleted": false
},
"published_at": "2026-09-26T10:58:20.000Z",
"ext": {
"subreddit": "ClaudeAI",
"title": "Sample comment text (redacted).",
"selftext": "Don't forget to claim it guys!",
"upvote_ratio": 0.8089887640449438,
"flair": "Promotion",
"content_language": "en",
"published_at_epoch": 1790420300
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": null,
"relevance": {
"p": 0.89,
"sense": "target",
"depth": 0.96,
"spam": 0.85
},
"labels": null
}
}
],
"next_cursor": "sc2.eyJzIjoicCIsImMiOiJzYzEuZXlKaklqb2lUV3BSUFNJc0luTWlPbHNpTVhkeVkydG9jQ0lzSWpGM2NXNXVOWGdpTENJeGQzSmpiV3B1SWl3aU1YZG5lalpzWmlJc0lqRjNjakZ6TjNvaUxDSXhkelZtTTJKNElpd2lNWGR3TmpCaGVTSXNJakYzYUdkbGRYa2lMQ0l4ZHpONFpHOXBJaXdpTVhaMmJ6RmhOU0lzSWpGM2JITTVkV3dpTENJeGQyZzNhWE5ySWl3aU1YUjRkV05pWVNJc0lqRjJhblZ5Y1hvaUxDSXhkMlF6Tlc5M0lpd2lNWFZ5ZW5JeGNTSXNJakYzT0dVMmFUVWlMQ0l4ZDI5MmQyRnZJaXdpTVhacWRqTjZPQ0lzSWpGMWNURXdPV2tpTENJeGMzQndaM2RrSWl3aU1YWmhjbWcyYVNJc0lqRjJkSG80TlhBaUxDSXhkM0F5WlRCMElpd2lNWFoyWVRoeGVTSmRmUSJ9",
"total": null,
"relevance": {
"mode": "score",
"topic_source": "query",
"rows": 25,
"scored": 25,
"cached": 0,
"kept": 25,
"dropped": 0,
"dropped_ids": [],
"unjudged": 0,
"too_short": 0,
"threshold": 0.5,
"extra_credits": 0,
"methodology_version": "relevance/2",
"origin": "default",
"pending": 0,
"pending_ids": [],
"status": "complete"
},
"labels": {
"presets": [
"sponsored",
"intent"
],
"rows": 25,
"labelled": 3,
"cached": 3,
"skipped": 0,
"unjudged": 0,
"dropped": 0,
"dropped_ids": [],
"extra_credits": 0,
"methodology_version": "labels/1",
"mode": "default",
"status": "partial",
"pending": 22,
"pending_ids": [
"1wqnn5x",
"1wrcmjn"
]
},
"dropped": 0
},
"credits_used": 1,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": "sc.eyJ2IjoyLCJjIjoic2MyLmV5SnpJam9pY0NJc0ltTWlPaUp6WXpFdVpYbEtha2xxYjJsVVYzQlNVRk5KYzBsdVRXbFBiSE5wVFZoa2VWa3lkRzlqUTBselNXcEdNMk5YTlhWT1dHZHBURU5KZUdRelNtcGlWM0IxU1dsM2FVMVlaRzVsYWxweldtbEpjMGxxUmpOamFrWjZUak52YVV4RFNYaGtlbFp0VFRKS05FbHBkMmxOV0dSM1RtcENhR1ZUU1hOSmFrWXpZVWRrYkdSWWEybE1RMGw0WkhwT05GcEhPWEJKYVhkcFRWaGFNbUo2Um1oT1UwbHpTV3BHTTJKSVRUVmtWM2RwVEVOSmVHUXlaek5oV0U1eVNXbDNhVTFZVWpSa1YwNXBXVk5KYzBscVJqSmhibFo1WTFodmFVeERTWGhrTWxGNlRsYzVNMGxwZDJsTldGWjVaVzVKZUdOVFNYTkpha1l6VDBkVk1tRlVWV2xNUTBsNFpESTVNbVF5Um5aSmFYZHBUVmhhY1dScVRqWlBRMGx6U1dwR01XTlVSWGRQVjJ0cFRFTkplR016UW5kYU0yUnJTV2wzYVUxWVdtaGpiV2N5WVZOSmMwbHFSakprU0c4MFRsaEJhVXhEU1hoa00wRjVXbFJDTUVscGQybE5XRm95V1ZSb2VHVlRTbVJtVVNKOSIsImUiOiJyZWRkaXQvc2VhcmNoIiwicCI6ImFmdGVyIn0",
"has_more": true,
"page_size": 25
},
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T07:26:20.953Z",
"redacted": true
}Hand this job to your coding agent
Paste this prompt into Claude Code, Cursor or any agent that can make HTTP requests. It names every endpoint and parameter the job needs.
Prompt
Use the SocialCrawl API for this job: Search discussions for a product category and mark the posts where someone is looking to buy.
Base URL: https://www.socialcrawl.dev. Send the API key in the x-api-key header (an Authorization: Bearer header also works). Values in braces are placeholders to fill.
1. GET /v1/reddit/search?query=best%20crm%20for%20startups&label=intent&relevance=filter
Every response is JSON with data, credits_used and request_id. The full endpoint reference is at https://www.socialcrawl.dev/llms.txt.FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usWhat does label=intent add?
It adds a judgement to each post under computed.labels, marking whether the author is looking to buy. You filter on that label to keep the threads where someone asked for a recommendation.
What does relevance=filter do?
It scores each post against your query and drops the ones that are not about it, which keeps a search for a CRM from returning unrelated threads. The response reports how many rows were kept and dropped.
What does each post include?
Each post has the title, score, comment count, subreddit, permalink and the body text at ext.selftext, plus the labels. Bodies arrive free with this endpoint, so include_body=true is rarely needed.
How many posts come back and how do I get more?
A page holds up to 25 posts and varies. Pass next_cursor from the response into the next request to continue. To search inside one community only, the registry points to subreddit/search.
Can I read the comments of a promising thread?
Yes. Take the post url from a result and send it to prism/comments, which collects the comments on a Reddit post and tags buying intent on the first 100 of each call.
How much does one run cost?
One run of the example above costs 1 credit across one API call. Every new account gets 100 free credits, credits for failed or empty calls are refunded automatically, and there is no subscription.
Ask AI about SocialCrawl