Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
community-members otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
ApiPass의 통합 GraphQL 엔드포인트를 통해 Twitter/X 커뮤니티의 페이지네이션된 커뮤니티 멤버 데이터를 조회하세요. 풍부한 사용자 프로필, 커뮤니티 역할, 커서 기반 페이지네이션이 기본 제공됩니다.
ApiPass의 Twitter GraphQL Community Members API는 모든 Twitter/X 커뮤니티의 전체 멤버 목록을 반환하는 비동기 작업 기반 엔드포인트입니다. model twitter/graphql/community-members와 대상 communityId를 포함해 /api/v1/jobs/createTask로 POST 요청을 보내면 taskId를 반환받고, 이후 /api/v1/jobs/recordInfo를 폴링하거나 webhook 콜백으로 결과를 받을 수 있습니다. 각 응답에는 구조화된 커뮤니티 메타데이터와 페이지네이션된 members_slice가 포함되며, 여기에는 display name, screen name, avatar URL, rest_id, 인증 상태(is_blue_verified), 그리고 특히 community_role 필드(예: Admin, Member)를 포함한 상세 멤버 레코드가 들어 있습니다. 또한 모든 규모의 커뮤니티를 계속 페이지네이션할 수 있도록 next_cursor가 함께 제공됩니다.
Twitter의 길고 복잡한 신청, 승인, elevated-access 절차를 건너뛰세요. ApiPass 대시보드에서 Bearer token을 생성하고 몇 분 안에 호출을 시작할 수 있습니다.
호출당 $0.0005(0.1 credits)로, ApiPass는 동등한 Twitter 엔터프라이즈 엔드포인트의 예상 비용보다 약 99.90% 저렴합니다. 10,000회 호출당 약 ~$45.45를 절감할 수 있습니다.
모든 멤버 레코드에는 프로필 핵심 정보(name, screen_name), avatar.image_url, rest_id, 인증 플래그, 관계 관점, community_role이 포함되어 제공되므로 추가 보강 호출이 필요 없습니다.
기본 channel: auto 설정은 starter, regular, official 제공자 간에 작업을 실시간으로 분산하여, 수동 구성 없이 비용과 안정성을 최적화합니다.
한 번 제출하면 taskId를 받고, 폴링하거나 callBackUrl을 제공해 결과가 준비되는 즉시 서버로 푸시되도록 할 수 있습니다. 커서 기반 페이지네이션이 필요한 대규모 커뮤니티에 특히 적합합니다.
모든 엔드포인트 페이지는 실시간 성공률(현재 100%)을 표시하므로, 연동 개발 전에 항상 API 상태를 확인할 수 있습니다.
input.variables.communityId만 필요합니다. Twitter 커뮤니티 ID(예: 1517189118140325888)를 전달하면 전체 멤버 슬라이스를 받을 수 있으며, 복잡한 GraphQL 변수를 구성할 필요가 없습니다.
모든 응답에는 members_slice.slice_info.next_cursor가 포함되어 있어, 소규모 틈새 그룹부터 수만 명의 멤버가 있는 커뮤니티까지 어떤 규모의 커뮤니티든 페이지 단위로 탐색할 수 있습니다.
각 멤버 객체에는 community_role 필드(Admin, Member 등)가 포함되어 있어, 운영자를 필터링하거나 핵심 사용자를 식별하거나 커뮤니티 내부의 거버넌스 구조를 매핑하기가 매우 쉽습니다.
정기적으로 멤버십을 스냅샷으로 저장하여 커뮤니티 규모, 성장 곡선, 관리자 변동, 시간에 따른 멤버 구성을 시각화할 수 있습니다.
틈새 커뮤니티에서 멤버 명단을 추출하고 is_blue_verified 또는 community_role로 필터링하여 마케팅 아웃리치에 적합한 고신호 계정을 찾아낼 수 있습니다.
screen_name과 rest_id를 사용해 기존 고객이 속한 Twitter 커뮤니티를 매핑하고, 커뮤니티 기반 관심 신호로 프로필을 보강할 수 있습니다.
커뮤니티 소유자가 Discord, Slack 또는 내부 CRM과 통합할 수 있는 모더레이션 도구, 크로스 플랫폼 멤버 미러링, 관리자 대시보드를 구현할 수 있습니다.
Twitter의 공식 API는 개발자 계정, 프로젝트 설정, 그리고 (커뮤니티 수준 GraphQL 데이터의 경우) 상위 유료 액세스가 필요하며, 승인 지연이 몇 주씩 걸리는 경우도 많습니다. ApiPass는 대시보드에서 생성한 API 키만 있으면 되며, 가입 후 몇 분 안에 첫 createTask 요청을 실행할 수 있습니다.
Twitter의 공식 Basic 및 Pro 티어는 월 수백에서 수천 USD의 비용이 들고 엄격한 월간 한도가 있습니다. ApiPass는 여러 제공자 채널 전반에서 종량제 방식으로 호출당 $0.0005를 청구합니다. 예상 비용을 99.90% 낮출 수 있어, 고정 월간 약정 없이 커뮤니티 스크래핑 워크로드를 확장할 수 있습니다.
크립토, NFT 또는 DAO 관련 Twitter 커뮤니티의 멤버십 변화를 모니터링하여 프로젝트 모멘텀이나 자본 순환의 초기 신호를 감지할 수 있습니다.
커뮤니티 멤버 목록과 tweet-timeline API를 결합하여 특정 브랜드 또는 제품 커뮤니티 내부에서 발생하는 대화에 대해 타겟 감성 분석을 실행할 수 있습니다.
경쟁사의 Twitter 커뮤니티를 추적하여 누가 가입하는지, 얼마나 빠르게 성장하는지, 어떤 인증 계정이 자사 오디언스와 겹치는지 확인할 수 있습니다.
온라인 그룹 형성, 정보 확산, 탈중앙화 소셜 네트워크에서의 관리자/멤버 역학 연구를 위해 익명화된 커뮤니티 멤버십 데이터셋을 수집할 수 있습니다.
ApiPass에 가입하고 대시보드의 API Key Management 페이지에서 Bearer token을 생성하세요.
https://api.apipass.dev/api/v1/jobs/createTask로 POST 요청을 보내고, model: "twitter/graphql/community-members"와 input.variables.communityId를 대상 커뮤니티로 설정하세요. 선택적으로 webhook 전달을 위한 callBackUrl을 포함할 수 있으며, 자동 비용/안정성 최적화를 위해 channel은 auto로 두면 됩니다.
반환된 taskId를 사용해 GET /api/v1/jobs/recordInfo?taskId={taskId}를 조회하세요. data.state가 success에 도달하면 data.resultJson.resultObject.data.communityResults.result.members_slice.items_results에서 멤버 명단을 파싱하고, next_cursor를 사용해 나머지 멤버를 페이지네이션하세요.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
커뮤니티 멤버 목록을 가져옵니다.
이 API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "communityId": "string",
8 }
9 }
10}model필수string생성에 사용할 모델 이름입니다.
"twitter/graphql/community-members"
callBackUrl선택적string작업 완료 알림을 받을 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이 제공업체들이 실제 이미지 및 동영상 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체에 작업을 자동으로 배분하여 비용 최소화와 안정적인 성능의 균형을 맞춥니다. 별도의 라우팅 요구사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
입력 객체에는 다음 파라미터가 포함됩니다:
input.variables.communityId필수string1517189118140325888
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "twitter/graphql/community-members",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "communityId": "1517189118140325888"
10 }
11 }
12 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공을, 그 외 값은 실패를 의미합니다.
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다.
data.taskId작업 상태와 결과를 조회하는 데 사용하는 작업 ID입니다.
