Reddit Subreddits Search API
API 한 번의 호출로 Reddit Subreddits Search 데이터를 받아 가세요. Finds communities by topic. Every other Reddit endpoint on this API needs you to already know the subreddit you want; this is the one that answers which communities discuss a subject. Returns up to 25 communities with the name, the subscriber count, the description, the icon, the NSFW flag and the community URL. `author.id` is the bare community name in Reddit's own casing, which is exactly what `/v1/reddit/subreddit`, `/v1/reddit/subreddit/details` and `/v1/reddit/subreddit/search` take as their `subreddit` parameter, so a discovery call feeds a listing call with no re-mapping in between. The row is the same Author shape `/v1/reddit/subreddit/details` returns. The search surface publishes nothing else, so on a plain call `author.joined_at`, `author.ext.weekly_active_users`, `author.ext.weekly_contributions`, `author.ext.rules_text` and `author.ext.language` are null on every row. Send `include=details` and every row is joined, in the same call, to the details lookup that carries them: the community's creation date, weekly active users, weekly contributions and rules land on each row (rules stay null for a community that publishes none), and the language on most rows (it comes from a second source that can miss a row on a busy page, so treat it as usually present). When the details lookup's main source cannot answer a row, its second source still fills the creation date and the language and that row is billed as filled, but the weekly numbers and the rules stay null on it; `data.hydration` counts it among the filled rows. Cost: 1 credit for the page plus 1 credit per row filled from a fresh lookup (25 rows, so 26 at most); rows already in cache are filled for free, rows that could not be filled are refunded, and a repeat of the same call within the cache window is 0. Time: a plain call is about 1 second; `include=details` adds 3 to 9 seconds on a fresh page (the lookups run in parallel and the call waits for the slowest, never more than 12 seconds) and nothing when the rows are already cached. `limit=N` (1 to 25) takes the top N communities of the page and, with `include`, caps the extra credits at N. The response carries a `hydration` block itemising rows, lookups, cache hits, credits and milliseconds. The subscriber count on a search row is the search index's own figure; the join never overwrites a value the row already carries. Note the name: this is `subreddits/search` and it finds COMMUNITIES, where the singular `subreddit/search` searches posts INSIDE one community. Paginate with `cursor`. A query that matches nothing still returns communities rather than an empty list, which is Reddit's own search behaviour, so judge relevance on the rows.
2026년 10월 업데이트SocialCrawl 팀이 직접 관리해요
주제에 맞는 커뮤니티를 최대 25개 돌려줍니다. author.id에 서브레딧 이름이 그대로 담기고 구독자 수, 설명, 아이콘이 함께 옵니다. include=details를 붙이면 개설일, 주간 활동, 규칙, 언어가 행마다 채워집니다.
어떤 주제를 어느 커뮤니티가 이야기하는지 찾을 때 쓰세요. 커뮤니티마다 subreddit/details를 부르는 대신 include=details를 붙이면 채운 행마다 1크레딧이 더해져 최대 26크레딧입니다.
69개 플랫폼을 병렬로 검색합니다
Subreddits Search API로 무엇을 할 수 있을까요
Subreddits Search 엔드포인트가 통합 스키마와 계산 필드를 담은 Reddit 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.
요청 예시
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/reddit/subreddits/search?query=machine+learning"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/reddit/subreddits/search",
params={
'query': 'machine learning',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/reddit/subreddits/search?query=machine+learning",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
| query | 예 | Topic or keyword to find communities for. |
| cursor | 아니오 | Cursor to get more results. Get 'cursor' from the previous response. |
| include | 아니오 | Set to `details` (one token only) to fill `author.joined_at`, `author.ext.weekly_active_users`, `author.ext.weekly_contributions`, `author.ext.rules_text` and `author.ext.language` on every row in this one call (a row the details lookup's main source cannot answer gets only the creation date and the language, and is still billed). Holds 1 credit per row (at most 25, or `limit`) and keeps only the rows filled from a fresh lookup; rows already in cache and rows that could not be filled are refunded, so the most a call can cost is 1 + rows. Adds 3 to 9 seconds on a fresh page (never more than 12) and nothing when the rows are already cached; read `data.hydration` for the rows, the credits held and kept, and the time. (details) |
| limit | 아니오 | Take the top N communities of the page (1 to 25). With `include=details` it also caps the extra credits at N, so `limit=5&include=details` holds 6 credits, not 26. It is not a page size: the cursor still advances past the whole page, so rows beyond N are not returned by the next page. |
Reddit Subreddits Search API는 무엇을 돌려주나요
모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.
응답 예시 보기
{
"success": true,
"platform": "reddit",
"endpoint": "/v1/reddit/subreddits/search",
"data": {
"items": [
{
"author": {
"id": "user_0b2f67",
"username": "user_0b2f67",
"display_name": "user_0b2f67",
"avatar_url": "https://example.com/avatars/user_37b18d.png",
"bio": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"verified": null,
"followers": 3075004,
"following": null,
"posts_count": null,
"likes_count": null,
"url": "https://example.com/user_05e113",
"private": null,
"joined_at": null,
"ext": {
"is_nsfw": false,
"weekly_active_users": null,
"weekly_contributions": null,
"rules_text": null,
"language": null
}
}
},
{
"author": {
"id": "user_21b48e",
"username": "user_21b48e",
"display_name": "user_21b48e",
"avatar_url": null,
"bio": "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).",
"verified": null,
"followers": 682525,
"following": null,
"posts_count": null,
"likes_count": null,
"url": "https://example.com/user_5311fd",
"private": null,
"joined_at": null,
"ext": {
"is_nsfw": false,
"weekly_active_users": null,
"weekly_contributions": null,
"rules_text": null,
"language": null
}
}
}
],
"next_cursor": "sc1.eyJjIjoiTWpRPSIsInMiOltdfQ",
"total": null,
"dropped": 0
},
"credits_used": 1,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": "sc.eyJ2IjoyLCJjIjoic2MxLmV5SmpJam9pVFdwUlBTSXNJbk1pT2x0ZGZRIiwiZSI6InJlZGRpdC9zdWJyZWRkaXRzL3NlYXJjaCIsInAiOiJjdXJzb3IifQ",
"has_more": true,
"page_size": 2
},
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T07:33:19.717Z",
"redacted": true
}통합 응답 구조를 보여 주는 실제 샘플이에요. 필드 값은 조회한 대상에 따라 달라져요.
Reddit Subreddits Search API는 어떻게 동작하나요
API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.
메서드
GET
응답 형식
JSON
소셜 미디어 데이터를 몇 초 만에 수집하는 방법
개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 69개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.
모든 플랫폼을 하나의 스키마로
동일한 응답 구조로 69개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.
단순 수집을 넘어 계산된 필드 제공
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 engagement_rate, estimated_reach, content_category, language를 함께 담아 바로 활용할 수 있습니다.
코드 한 줄 쓰기 전에, 데이터부터
Visual Data Explorer에 URL만 붙여넣으면 결과 카드와 정형화된 테이블, CSV 내보내기를 바로 사용할 수 있습니다.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기주제로 서브레딧을 찾으려면 어떻게 하나요?
주간 활성 사용자 수까지 한 번에 받을 수 있나요?
서브레딧 검색 API 요금은 얼마인가요?
받아 오는 커뮤니티 수를 줄일 수 있나요?
검색 결과를 다른 Reddit 엔드포인트에 바로 넘길 수 있나요?
AI에게 SocialCrawl을 물어보세요
Reddit Subreddits Search 데이터, 가져올 준비 되셨어요?
API 키 받고 60초 안에 Reddit 데이터를 받아 가세요.
