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로 진행 상황을 확인하고 결과를 가져옵니다.
- 공개 커뮤니티 페이지를 열어 /i/communities/ 링크를 복사합니다. 조회할 커뮤니티마다 링크를 하나씩 준비하세요.
- 예제를 실행하기 전에 $SOCQ_API_KEY를 본인의 API 키로 바꾸거나 해당 환경 변수를 설정합니다. 아래 예제처럼 Authorization 헤더를 포함해 JSON 입력을 POST /v1/x/community로 보내고, 응답의 task_id를 저장합니다.
- 저장한 ID로 GET /v1/tasks/{task_id}를 호출해 진행 상황을 확인합니다. queued는 대기 중, running은 수집 진행 중, retrying은 재시도 중이라는 뜻입니다. succeeded가 되면 결과를 읽고, 작업이 failed이면 error_message에서 사유를 확인하세요.
- 작업이 성공하면 data.results.items를 읽습니다. 이 목록의 각 항목은 커뮤니티 하나의 상세 정보를 나타내며, 목록이 비어 있으면 레코드 없이 작업이 완료되었다는 뜻입니다.
- 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를 매칭 키로 사용하세요.
- 커뮤니티를 비교할 때 멤버 수는 규모를 보여 주는 지표로만 쓰고, 멤버들이 얼마나 활발히 게시하는지를 나타내는 근거로 보지 마세요. 이 결과에는 활동 내역이나 개별 멤버 목록이 없습니다.
관련 API
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 — 커뮤니티를 운영하는 관리자와 모더레이터의 프로필을 가져옵니다.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API