x/
community

X 커뮤니티 링크에서 소개글, 멤버 수, 규칙 등 공개 커뮤니티 상세 정보를 읽어 오며, 여러 커뮤니티를 한 번에 조회할 수 있습니다.

X Community API

커뮤니티 상세 정보
멤버·운영자 수
규칙과 가입 정책
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

X Community

X 커뮤니티는 이름, 소개글, 멤버 수, 참여 규칙을 갖춘 주제 기반 토론 공간입니다. 이러한 상세 정보를 보면 커뮤니티의 주제를 파악하고, 다른 커뮤니티와 규모를 비교하고, 토론을 살펴보기 전에 참여 정책을 확인할 수 있습니다.

X Community API 주요 기능

  • 커뮤니티가 어떤 곳인지 파악커뮤니티 이름, 공개 소개글, 링크, 커버 이미지, 개설자 정보를 함께 받아, 게시물을 찾아보기 전에 공간을 식별하고 안내된 주제를 확인할 수 있습니다.
  • 멤버 규모와 참여 정책 확인멤버 수와 운영자 수를 join_policy, invites_policy와 함께 받습니다. 이 두 필드는 가입과 멤버 초대가 어떻게 처리되는지 설명합니다.
  • 커뮤니티 자체 규칙 읽기규칙 목록에는 규칙 이름과 설명이 들어 있어, 참여 조건을 커뮤니티 기본 정보와 함께 보관할 수 있습니다.

X Community API 매개변수

매개변수필수설명
urls필수숫자 커뮤니티 ID가 포함된 공개 X 커뮤니티 링크의 목록으로, 필수 값입니다(예: https://x.com/i/communities/1493446837214187523). Playground에서는 한 줄에 링크 하나씩 입력하고, 코드에서는 JSON urls 배열을 사용하세요. 프로필, 검색, 개별 게시물 링크는 사용할 수 없습니다.

X Community API 사용 방법

요청을 보내면 백그라운드 수집 작업이 시작되므로, 첫 응답에는 완성된 데이터가 아니라 작업 ID가 담깁니다. 이 ID로 진행 상황을 확인하고 결과를 가져옵니다.

  1. 공개 커뮤니티 페이지를 열어 /i/communities/ 링크를 복사합니다. 조회할 커뮤니티마다 링크를 하나씩 준비하세요.
  2. 예제를 실행하기 전에 $SOCQ_API_KEY를 본인의 API 키로 바꾸거나 해당 환경 변수를 설정합니다. 아래 예제처럼 Authorization 헤더를 포함해 JSON 입력을 POST /v1/x/community로 보내고, 응답의 task_id를 저장합니다.
  3. 저장한 ID로 GET /v1/tasks/{task_id}를 호출해 진행 상황을 확인합니다. queued는 대기 중, running은 수집 진행 중, retrying은 재시도 중이라는 뜻입니다. succeeded가 되면 결과를 읽고, 작업이 failed이면 error_message에서 사유를 확인하세요.
  4. 작업이 성공하면 data.results.items를 읽습니다. 이 목록의 각 항목은 커뮤니티 하나의 상세 정보를 나타내며, 목록이 비어 있으면 레코드 없이 작업이 완료되었다는 뜻입니다.
  5. data.results.has_more가 true이면 next_cursor 값이 저장된 결과의 다음 페이지를 가리키는 표식입니다. 이 값을 그대로 GET /v1/tasks/{task_id}?cursor=...의 cursor 매개변수에 넣고, has_more가 false가 될 때까지 반복합니다.
curl -X POST "https://api.socq.ai/v1/x/community" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/communities/1493446837214187523"]}'

X Community API 추천 활용 사례

  • 탐색할 커뮤니티 디렉터리 만들기: 커뮤니티 이름, 소개글, 링크, 멤버 수를 표로 정리해 두면, 어떤 토론을 읽을지 정하기 전에 입력한 커뮤니티를 주제와 규모로 비교할 수 있습니다.
  • 토론 검토와 함께 참여 규칙 보관: 규칙과 멤버십 정책을 커뮤니티 ID별로 저장해 두고, 검토할 게시물은 X Community Posts로 따로 수집해 해당 커뮤니티 정보에 연결합니다.

X Community API 활용 팁

  • 커뮤니티 페이지가 아니라 게시물에서 시작한다면, 이 조회는 게시물 URL로 소속 커뮤니티를 알아내지 않으므로 먼저 공개 커뮤니티 링크를 찾으세요.
  • 같은 커뮤니티가 x.com과 twitter.com 링크로 함께 나타나면, 디렉터리에 중복 항목이 생기지 않도록 /i/communities/ 뒤의 숫자 ID를 매칭 키로 사용하세요.
  • 커뮤니티를 비교할 때 멤버 수는 규모를 보여 주는 지표로만 쓰고, 멤버들이 얼마나 활발히 게시하는지를 나타내는 근거로 보지 마세요. 이 결과에는 활동 내역이나 개별 멤버 목록이 없습니다.

X Community API 외에 X의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Twitter Profile Scraper API — 사용자 이름으로 공개 계정 정보, 소개글, 프로필 이미지, 커버 이미지, 계정 상태, 공개된 오디언스 통계를 가져옵니다.
  • X Followers List API — X 사용자 이름 하나 이상에 대해 공개 팔로워 계정 정보와 공개된 프로필 지표를 수집합니다.
  • X Following List API — 공개 X 계정이 팔로우하는 프로필을 수집하며, 계정 정보, 소개글, 계정 신호, 공개된 카운터, 출처 사용자 이름을 포함합니다.
  • X Community Posts API — 커뮤니티에 공유된 공개 게시물을 텍스트, 작성자, 상호작용 수와 함께 가져옵니다.
  • X Community Members API — 커뮤니티 멤버를 소개글과 팔로워 수가 담긴 프로필로 내보냅니다.
  • X Community Moderators API — 커뮤니티를 운영하는 관리자와 모더레이터의 프로필을 가져옵니다.

다른 플랫폼 둘러보기

X 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

X Community API — 자주 묻는 질문

X Community API는 커뮤니티 링크 목록에서 공개 X 커뮤니티 정보를 가져오는 프로그래밍 인터페이스입니다. 커뮤니티 이름, 소개글, 멤버·운영자 수, 규칙, 가입 정책을 반환하므로 게시물을 살펴보기 전에 각 커뮤니티를 파악할 수 있습니다.

커뮤니티 링크에는 /i/communities/ 뒤에 숫자 ID가 붙습니다. 프로필 링크는 계정을, /status/ 링크는 게시물을 가리키므로 둘 다 이 조회의 입력이 될 수 없습니다.

아니요. 수치는 커뮤니티의 멤버가 몇 명인지만 알려 주며 누구인지는 알려 주지 않습니다. 응답에 멤버 목록은 없습니다.

아니요. 이 조회는 커뮤니티의 소개글, 규칙 등 메타데이터를 반환합니다. 토론 내용 자체가 필요하면 같은 커뮤니티 링크로 X Community Posts를 사용하세요.

아니요. X 커뮤니티는 공통된 토론 주제를 중심으로 구성된 공간이고, 커뮤니티 노트는 게시물에 붙는 주석이며 이 조회에서 반환되는 대상이 아닙니다.

반환된 커뮤니티 레코드 하나당 0.5 크레딧이며 기본 요금은 없습니다. 예를 들어 커뮤니티 링크 네 개를 제출하면 2 크레딧으로 예상되고, 커뮤니티 레코드 네 개가 반환되면 2 크레딧이 차감됩니다.