XTwitterX 리스트X 커뮤니티X 스페이스API 가이드

X API 신규 엔드포인트: 리스트, 커뮤니티, 스페이스, 아티클, 계정 위치

SocQ X(Twitter) 신규 엔드포인트 14개로 계정 위치, 인증된 팔로워, 팔로우 확인, 리스트, 커뮤니티, 미디어와 답글, 아티클, 스페이스, 동영상 스크립트를 가져옵니다.

SocQ2026년 11월 19일 업데이트약 9분 소요

SocQ의 X 엔드포인트는 이미 공개 프로필, 게시물, 타임라인, 검색, 답글, 인용, 팔로워, 트렌드를 반환해 왔으며, 이 내용은 X/Twitter 수집 가이드에서 다룹니다. 2026-11-17에는 엔드포인트 14개가 X 플랫폼 페이지에 추가로 공개되었습니다. 기본 엔드포인트로는 닿지 않던 X의 영역, 즉 "이 계정 정보(About this account)" 패널, 리스트, 커뮤니티 멤버와 모더레이터, 사용자의 미디어 탭과 답글 탭, 장문 아티클, 스페이스, 동영상 속 음성까지 다룹니다.

이 가이드에서는 새 엔드포인트를 용도별로 묶고, 각각의 요청 예시와 가격을 소개합니다.

빠른 답변: POST https://api.socq.ai/v1/x/<endpoint>에 JSON 본문을 보내세요. 반환된 task_id를 저장하고 status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 뒤 data.results.items를 읽습니다. 14개 엔드포인트 모두 결과 1건당 0.7 크레딧($0.0035)이며, Video Transcript의 긴 동영상만 예외입니다.

신규 X 엔드포인트 한눈에 보기

1 SocQ 크레딧 = $0.005입니다. 기본 요금이 없으므로 결과가 비어 있으면 비용이 발생하지 않습니다.

엔드포인트반환 내용가격
X Account Location API계정의 소재 국가, X 접속 경로, 가입일, 사용자 이름 변경 내역계정 1개당 0.7 크레딧($0.0035)
X Verified Followers API프로필을 팔로우하는 인증 계정팔로워 1명당 0.7 크레딧($0.0035)
Twitter Follow Checker API최대 100쌍의 팔로우, 피팔로우, 맞팔로우 여부1쌍당 0.7 크레딧($0.0035)
X List Tweets API리스트 타임라인(최신순, 리포스트 표시 포함)게시물 1개당 0.7 크레딧($0.0035)
Twitter List Members API리스트에 포함된 계정의 전체 프로필멤버 1명당 0.7 크레딧($0.0035)
Twitter List Followers API리스트를 팔로우하는 계정의 전체 프로필팔로워 1명당 0.7 크레딧($0.0035)
X Communities Search API키워드와 일치하는 커뮤니티와 멤버 수, URL커뮤니티 1개당 0.7 크레딧($0.0035)
X Community Members API커뮤니티 멤버의 전체 프로필멤버 1명당 0.7 크레딧($0.0035)
X Community Moderators API커뮤니티의 관리자와 모더레이터모더레이터 1명당 0.7 크레딧($0.0035)
Twitter Media Scraper API계정 미디어 탭의 게시물과 원본 화질 파일게시물 1개당 0.7 크레딧($0.0035)
X User Replies API계정이 작성한 답글과 각 답글이 응답한 게시물답글 1개당 0.7 크레딧($0.0035)
X Articles API아티클 제목, 미리보기 문구, 전체 본문, 커버, 참여 지표아티클 1개당 0.7 크레딧($0.0035)
X Spaces API스페이스 상태, 일정, 호스트, 스피커, 청취자, 다시 듣기스페이스 1개당 0.7 크레딧($0.0035)
Twitter Video Transcript API게시물 동영상의 음성 텍스트와 길이2분 이하 동영상 1개당 0.7 크레딧($0.0035)

인증과 비동기 작업 흐름

모든 요청은 API 키로 인증합니다. 제출, 작업 상태 조회, 결과 조회 요청에 같은 헤더를 사용합니다.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

모든 수집은 백그라운드 작업으로 실행됩니다.

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

제출 호출은 즉시 data.task_id와 data.status를 반환합니다. 이 ID로 작업을 폴링하세요.

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

status가 succeeded가 되면 응답에 result_count, credits_amount, 그리고 data.results.items에 담긴 정규화 레코드의 첫 페이지가 포함됩니다. limit의 기본값은 50이고 최대 500입니다. results.has_more가 true이면 results.next_cursor를 cursor로 전달해 다음 페이지를 읽으세요. 실패한 작업에는 error_message가 담깁니다.

아래의 모든 엔드포인트는 선택 사항인 callback_url도 받습니다. 작업이 끝나면 SocQ가 작업 요약을 담은 POST를 한 번 보내며, 레코드는 작업 엔드포인트에서 읽습니다. 클라이언트 측 타임아웃이 작업을 취소하지는 않으므로 다시 제출하지 말고 같은 작업 ID로 조회를 이어가세요. 402는 계정의 크레딧이 부족하다는 뜻이고, 429는 키가 속도 또는 크레딧 한도에 도달했다는 뜻입니다.

results_limit 참고: Verified Followers와 리스트·커뮤니티 멤버 엔드포인트에서는 입력마다 적용되며, 기본값은 100이고 20부터 2000 사이의 20의 배수여야 합니다. Communities Search에서는 10부터 500 사이의 10의 배수여야 합니다.

계정과 관계 검증하기

Account Location은 "이 계정 정보(About this account)" 패널을 읽어 country, connected_via(예: United States App Store 또는 Web), 가입일, username_changes_count, affiliate_username을 반환합니다. 인플루언서를 검증하거나 조직적으로 움직이는 계정을 찾아낼 때 사용하세요. 상당수 정부 계정처럼 국가 정보가 없는 계정도 있으며, 이런 계정도 country: null인 행으로 반환됩니다. (문서)

curl -X POST "https://api.socq.ai/v1/x/user-about" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["elonmusk", "BBCWorld"]}'

Verified Followers는 X의 인증된 팔로워 탭에 표시되는 목록을 반환합니다. 각 행은 인증된 팔로워(actor)를 조회한 계정(related_actor)과 연결합니다. 오디언스 중 영향력 있는 층의 규모를 가늠하거나 경쟁사 팔로워로 아웃리치 목록을 만들 때 사용하세요. (문서)

curl -X POST "https://api.socq.ai/v1/x/verified-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["NASA"], "results_limit": 20}'

Follow Checker는 username 하나를 최대 100개의 usernames와 비교합니다. 각 쌍은 is_following, is_followed_by, is_mutual을 반환합니다. 캠페인 참여자가 브랜드를 팔로우하는지 확인할 때 사용하세요. (문서)

curl -X POST "https://api.socq.ai/v1/x/check-follow" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "usernames": ["SpaceX", "NASA"]}'

X 리스트 읽기

세 엔드포인트 모두 /i/lists/{numeric_id} 형식의 공개 리스트 URL을 받습니다.

List Tweets는 리스트 타임라인을 최신순으로 반환합니다. 리포스트는 빠지지 않고 is_repost로 표시되며 reposted_post_id와 reposted_author도 함께 담기므로 필요하면 걸러낼 수 있습니다. 요청 하나로 특정 분야 전체를 모니터링할 수 있습니다. (문서)

curl -X POST "https://api.socq.ai/v1/x/list-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

List Members는 리스트에 포함된 계정을 소개, 위치, 웹사이트, 인증 여부, 팔로워 수·팔로잉 수·게시물 수가 담긴 전체 프로필로 내보냅니다. 사람이 직접 고른 리스트는 그대로 잠재 고객 발굴의 출발점이 됩니다. (문서)

curl -X POST "https://api.socq.ai/v1/x/list-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

List Followers는 리스트를 구독하는 계정을 같은 프로필 형식으로 반환합니다. 리스트를 팔로우한다는 것은 그 주제에 관심이 있다고 밝힌 것이므로, 정밀한 리서치 세그먼트가 됩니다. (문서)

curl -X POST "https://api.socq.ai/v1/x/list-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

X 커뮤니티 파악하기

Communities Search는 키워드로 커뮤니티를 찾아 이름, 멤버 수, 배너, is_nsfw, 커뮤니티 URL을 반환합니다. (문서)

curl -X POST "https://api.socq.ai/v1/x/search-communities" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "bitcoin", "results_limit": 20}'

커뮤니티 URL(/i/communities/{numeric_id})을 Community Members에 전달하면 멤버를 전체 프로필로 받을 수 있습니다. (문서)

curl -X POST "https://api.socq.ai/v1/x/community-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 20}'

Community Moderators는 관리자를 포함한 운영진 전체를 요청 한 번으로 반환합니다. 스폰서십이나 AMA를 제안할 때 연락할 대상입니다. (문서)

curl -X POST "https://api.socq.ai/v1/x/community-moderators" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/communities/1493446837214187523"]}'

커뮤니티 설명과 규칙은 커뮤니티 상세 정보 가이드에서, 커뮤니티 게시물은 커뮤니티 게시물 가이드에서 다룹니다.

계정의 미디어와 답글 수집하기

두 엔드포인트 모두 username 하나를 받으며, results_limit은 기본값 20이고 1부터 1000까지 받습니다.

Media Scraper는 계정 미디어 탭의 게시물을 최신순으로 반환하며 텍스트, 참여 지표, 조회수, 미디어 파일이 포함됩니다. 동영상은 제공되는 가장 높은 화질의 MP4를 가리킵니다. (문서)

curl -X POST "https://api.socq.ai/v1/x/user-media" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "NASA", "results_limit": 20}'

User Replies는 계정의 답글 탭을 최신순으로 반환합니다. 각 답글에는 응답 대상 게시물의 텍스트, 작성자, 링크, 시각이 담긴 in_reply_to가 있어 모든 행을 하나의 완결된 대화로 읽을 수 있습니다. (문서)

curl -X POST "https://api.socq.ai/v1/x/user-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "results_limit": 20}'

대화 전체가 필요하다면 스레드 맥락 가이드를 참고하세요.

아티클, 스페이스, 동영상 음성 읽기

Articles는 아티클을 게시한 게시물의 URL(/{username}/status/{post_id})을 받아 title, 미리보기 문구인 summary, text에 담긴 전체 본문, 커버 이미지, 작성자, 그리고 좋아요·답글·인용·조회수를 반환합니다. 아티클이 아닌 게시물은 행을 반환하지 않으며, 전달한 URL 중 아티클이 하나도 없으면 작업이 실패하고 과금되지 않습니다. (문서)

curl -X POST "https://api.socq.ai/v1/x/article" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/USDOL/status/2119796255089947070"]}'

Spaces는 /i/spaces/{space_id} 링크를 받습니다. 각 스페이스의 제목, status(예정 scheduled, 라이브 live, 종료 ended), scheduled_start_at, 호스트, 스피커, 실시간 청취자 수, 다시 듣기 조회수, is_replay_available을 반환합니다. (문서)

curl -X POST "https://api.socq.ai/v1/x/space" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]}'

Video Transcript는 게시물 동영상의 음성을 일반 텍스트로 바꾸고 duration_seconds를 함께 반환합니다. 2분 이하 동영상은 0.7 크레딧입니다. 더 긴 동영상은 전체 길이를 기준으로 시작된 1분마다 4 크레딧($0.02)이 부과되므로, 3분짜리 동영상은 12 크레딧($0.06)입니다. 동영상이 없는 게시물은 행을 반환하지 않으며 과금되지 않습니다. (문서)

curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/NASA/status/2119833829389041896"]}'

관련 X 가이드

SocQ를 다른 X 데이터 제공업체 및 공식 API와 비교하려면 Twitter API 요금과 X API 대안 추천, Twitter/X 스크래퍼 API 추천 7선, TwitterAPI.io 대안을 읽어 보세요.

자주 묻는 질문(FAQ)

X에 국가가 표시되지 않으면 X Account Location API는 무엇을 반환하나요?

country가 null인 행을 반환합니다. connected_via, 가입일 같은 나머지 필드는 그대로 반환됩니다.

results_limit은 왜 20의 배수여야 하나요?

Verified Followers, List Tweets, List Members, List Followers, Community Members에 적용되는 규칙으로, 입력마다 20부터 2000까지 20 단위로 지정합니다. Communities Search는 10부터 500까지 10 단위입니다.

아티클이 아니거나 동영상이 없는 게시물도 과금되나요?

아니요. 이런 게시물은 행을 반환하지 않으며, 반환된 행에 대해서만 비용을 지불합니다. Articles API에 보낸 URL 중 아티클이 하나도 없으면 작업이 실패하고 과금되지 않습니다.

긴 동영상의 스크립트 비용은 얼마인가요?

2분 이하는 0.7 크레딧입니다. 그보다 길면 전체 길이를 기준으로 시작된 1분마다 4 크레딧이 부과되므로, 3분은 12 크레딧, 5분은 20 크레딧($0.10)입니다.

여러 팔로우 관계를 한 번에 확인할 수 있나요?

네. Follow Checker는 요청 한 번으로 계정 하나를 최대 100개 계정과 비교하며, 1쌍당 0.7 크레딧이 과금됩니다.

X API

공개 X URL로 워크플로를 테스트하세요

공개 데이터 입력을 제출하면 출처를 추적할 수 있는 컨텍스트가 포함된 정규화된 레코드를 받을 수 있습니다.

X API 살펴보기