100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
Reddit logo
100 크레딧 무료, 카드 등록 없이

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개 플랫폼을 병렬로 검색합니다

·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
Reddit API

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
}

통합 응답 구조를 보여 주는 실제 샘플이에요. 필드 값은 조회한 대상에 따라 달라져요.

API 상세

Reddit Subreddits Search API는 어떻게 동작하나요

API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.

메서드

GET

응답 형식

JSON

왜 SocialCrawl인가요

Reddit Subreddits Search 데이터는 왜 SocialCrawl로 가져올까요

Reddit 데이터 추출에서 까다로운 부분은 SocialCrawl이 가려 드려요. 통합 스키마, AI 인리치먼트, 그리고 코드에 남지 않는 플랫폼 로직까지.

개발자 우선

소셜 미디어 데이터를 몇 초 만에 수집하는 방법

개발자를 위한 가장 빠른 소셜 미디어 스크래핑 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()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}
+ 69개 플랫폼
자주 묻는 질문

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기
주제로 서브레딧을 찾으려면 어떻게 하나요?
GET /v1/reddit/subreddits/search에 query를 담아 호출하면 돼요. 한 페이지에 최대 25개 커뮤니티가 오고, 각 행에 author.id의 커뮤니티 이름, 구독자 수, 설명, 아이콘, NSFW 여부가 담겨요.
주간 활성 사용자 수까지 한 번에 받을 수 있나요?
같은 호출에 include=details를 붙이면 돼요. 페이지의 모든 커뮤니티가 서브레딧 상세 조회와 합쳐져서 개설일, 주간 활성 사용자, 주간 게시 활동, 규칙, 언어가 행마다 채워져요.
서브레딧 검색 API 요금은 얼마인가요?
기본 검색은 standard 등급에서 1 credit예요. include=details를 붙이면 페이지 요금에 더해 새로 조회해 채운 커뮤니티마다 크레딧 하나가 붙어서 최대 26 크레딧이에요. 캐시에 있던 커뮤니티는 무료이고, 채우지 못한 커뮤니티는 환불돼요.
받아 오는 커뮤니티 수를 줄일 수 있나요?
limit으로 페이지 상위 N개만 받을 수 있어요. 1부터 25까지 넣을 수 있고, include=details와 함께 쓰면 추가 크레딧도 N개로 묶여서 다섯 개만 요청하면 추가 크레딧도 다섯 개까지만 잡혀요.
검색 결과를 다른 Reddit 엔드포인트에 바로 넘길 수 있나요?
네, author.id에 Reddit 표기 그대로의 커뮤니티 이름이 담겨요. /v1/reddit/subreddit, /v1/reddit/subreddit/details, /v1/reddit/subreddit/search의 subreddit 값으로 그대로 넣으면 돼요.

AI에게 SocialCrawl을 물어보세요

Reddit Subreddits Search 데이터, 가져올 준비 되셨어요?

API 키 받고 60초 안에 Reddit 데이터를 받아 가세요.

무료로 시작하기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요