Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
communities-fetch-one-query otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
ApiPass의 비동기 작업 기반 GraphQL 엔드포인트를 사용해 community ID만으로 특정 X (Twitter) Community의 전체 메타데이터를 가져옵니다.
ApiPass의 Twitter Graphql Communities Fetch One Query API는 X의 내부 CommunitiesFetchOneQuery GraphQL 작업을 감싼 래퍼로, communityId만으로 특정 X Community의 전체 프로필(이름, 설명, 멤버 수, 관리자, 규칙, 배너, 가입 정책, 공개 범위 등)을 가져올 수 있습니다. 기본 Twitter GraphQL 작업은 communityId 및 withDmMuting 같은 변수로 호출되므로, ApiPass는 동일한 파라미터를 깔끔하고 통합된 작업 기반 인터페이스로 제공합니다. /api/v1/jobs/createTask에 model twitter/graphql/communities-fetch-one-query로 작업을 제출하면 taskId를 받고, 이후 /api/v1/jobs/recordInfo를 폴링하거나 callback을 통해 완전히 채워진 community object를 받을 수 있습니다. OAuth 흐름도, rate-limit 조정도, X의 private GraphQL schema를 직접 리버스 엔지니어링할 필요도 없습니다.
Twitter의 애플리케이션 심사, 엔터프라이즈 요금제, access-token 로테이션을 건너뛰고 단일 ApiPass Bearer key로 인증해 즉시 community data를 가져오세요.
전체 Community objects를 제공하지 않는 공식 v2 REST API와 달리, ApiPass는 x.com 자체가 사용하는 동일한 CommunitiesFetchOneQuery 작업을 미러링하여 웹 앱에서 보는 모든 필드를 제공합니다.
작업을 실행한 뒤 결과를 폴링하거나 callBackUrl을 제공할 수 있습니다. serverless functions, queue-driven pipelines, 대량 batch enrichment에 적합합니다.
channel을 auto로 설정하면 ApiPass가 실시간 가격과 안정성을 기준으로 starter, regular, official providers 전반에 요청을 자동 분산하므로, 과도한 비용을 내거나 장애 가능성이 높은 upstream에 걸릴 일이 없습니다.
결과는 구조화된 resultJson string으로 반환되어 바로 파싱하고 데이터베이스에 적재할 수 있습니다. HTML scraping, headless browsers, cookie management가 필요 없습니다.
조회 도구를 위해 community 하나를 가져오든, research dataset을 위해 수만 개를 채우든, ApiPass의 호출당 요금은 scraping farm 또는 X Enterprise 계약을 유지하는 비용보다 저렴합니다.
유효한 communityId(예: 1517189118140325888)를 전달하면 한 번의 왕복 요청으로 community의 완전한 GraphQL 형태 record를 받을 수 있습니다.
withDmMuting boolean을 전환해 조회 계정과 community admins 간 direct-message muting 관계가 응답에 포함될지 제어할 수 있습니다. 이는 communityId 및 withDmMuting 변수를 받는 Twitter의 CommunitiesFetchOneQuery 작업에서 기본적으로 사용하는 동일한 flag입니다.
모든 작업은 명시적인 waiting → queuing → generating → success / fail 상태를 거치므로, 애플리케이션은 요청이 정확히 어느 단계에 있는지 항상 파악하고 그에 맞게 대응할 수 있습니다.
사용자가 붙여 넣은 모든 X Community에 대해 커버 이미지, 설명, 멤버 수, 관리자 목록을 표시하는 도구를 구축하세요. community explorer, directory site, 채팅 앱에 삽입되는 "preview card" widget에 적합합니다.
시간에 따라 community의 멤버 수, 규칙, admin roster를 스냅샷으로 저장해 성장 추세, milestone alerts, moderation changes를 파악하세요. community managers와 social-media strategists를 지원하는 analytics platforms에 이상적입니다.
이 엔드포인트를 community-members 또는 community-tweets endpoints와 결합해, marketers가 lead generation, competitive analysis, audience research에 이미 활용하는 워크플로를 구동하세요. 모든 community ID를 풍부한 prospect signal로 전환할 수 있습니다.
community의 metadata를 주기적으로 다시 가져와 policy changes, ownership transfers, visibility flips(public ↔ closed)를 감지하세요. 이를 통해 trust-and-safety teams, brand-safety vendors, community auditors가 위험을 선제적으로 파악할 수 있습니다.
데이터 커버리지와 개발자 경험 측면에서 ApiPass의 Communities Fetch One Query 엔드포인트가 X의 공식 개발자 플랫폼에서 실제로 제공되는 기능과 어떻게 다른지 살펴보세요.
X의 공식 API v2는 ID로 전체 Community metadata를 가져오는 first-class endpoint를 제공하지 않습니다. Communities는 여전히 내부 GraphQL operations로 구동되는 x.com 앱 기능에 가깝습니다. ApiPass는 X 웹 클라이언트가 사용하는 바로 그 CommunitiesFetchOneQuery 작업을 노출해 이 격차를 메우므로, 축소된 공개 subset이 아니라 실제 UI에 렌더링되는 내용과 동일한 수준의 데이터를 얻을 수 있습니다.
공식 API는 유료 X Developer tier, app review, OAuth 2.0 user context, 엄격한 per-app rate limits가 필요합니다. ApiPass는 이를 단일 Bearer token, async job queue, 여러 providers 간 비용과 안정성을 균형 있게 조정하는 auto channel routing으로 대체합니다. 즉, 몇 주가 아니라 몇 분 만에 zero에서 production까지 진행할 수 있습니다.
tweet이나 link에 언급된 모든 community ID를 해석해 monitoring feed에 실제 community context(이름, 규모, 주제)를 더하세요.
prospect가 프로필이나 온보딩 양식에 X Community를 기재하면, 설명, 멤버 수, admin handles로 이를 CRM에 채워 넣으세요.
온라인 그룹 역학, topic clustering, platform governance 연구를 위해 재현 가능한 Community metadata datasets를 구축하세요.
trust-and-safety investigations 또는 ad-suitability scoring과 관련된 communities의 membership policies, rules, admin composition을 추적하세요.
Authorization header에 Bearer token을 넣어 https://api.apipass.dev/api/v1/jobs/createTask로 POST request를 보내세요. JSON body에서 model을 twitter/graphql/communities-fetch-one-query로 설정하고, 대상 communityId(선택적으로 withDmMuting boolean 포함)를 담은 input object를 포함합니다. 결과를 자동으로 받고 싶다면 webhook endpoint를 가리키는 callBackUrl을 추가하세요.
create-task response는 data.taskId value(예: task_12345678)를 반환합니다. 다음 단계에서 task의 status와 results를 조회할 수 있도록 이 ID를 저장하세요. callBackUrl을 제공했다면 callback이 실행될 때까지 기다리기만 해도 됩니다.
Bearer token과 함께 https://api.apipass.dev/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID로 GET request를 보내세요. state field가 waiting → queuing → generating 단계를 거치는지 확인하고, success에 도달하면 resultJson field를 파싱해 전체 community object를 얻으세요. 이 데이터는 저장, 표시, downstream 전달에 바로 사용할 수 있습니다. state가 fail을 반환하면 함께 제공되는 failure details를 확인해 원인을 진단하고 재시도하세요.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
communities fetch one query
이 API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "communityId":"string",
8 "withDmMuting": "boolean"
9 }
10 }
11}model필수string생성에 사용할 모델 이름입니다.
"twitter/graphql/communities-fetch-one-query"
callBackUrl선택적string작업 완료 알림을 받을 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체는 실제 이미지 및 비디오 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기준으로 사용 가능한 제공업체에 작업을 자동 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구 사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 파라미터가 포함됩니다:
input.communityId필수stringcommunityId
1517189118140325888
input.withDmMuting선택적booleanwithDmMuting
false
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/communities-fetch-one-query",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "communityId": "1517189118140325888",
9 "withDmMuting": false
10 }
11 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공, 그 외 값은 실패를 의미합니다.
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다.
data.taskId작업 상태와 결과를 조회하는 데 사용하는 작업 ID입니다.
