아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
community-tweets-timeline otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
단일 API 호출로 모든 Twitter (X) 커뮤니티의 랭킹 기반 트윗 타임라인을 실시간으로 가져오세요.

ApiPass의 Twitter GraphQL 커뮤니티 트윗 타임라인 API는 특정 Twitter (X) 커뮤니티 내부에 게시된 트윗의 전체 랭킹 타임라인을 가져오는 강력한 엔드포인트입니다. communityId만 전달하면 개발자는 커뮤니티 범위의 대화, 상위 랭킹 게시물, 페이지네이션된 타임라인 항목에 접근할 수 있으며, 원활한 스크롤과 무한 로딩을 위한 커서도 포함됩니다. 인증, 속도 제한 또는 GraphQL 쿼리 구성을 직접 처리하지 않고도 X의 커뮤니티 기반 콘텐츠에 안정적이고 구조화된 방식으로 접근해야 하는 개발자를 위해 설계되었습니다.
번거로운 Twitter Developer 신청 절차를 건너뛰고 ApiPass API 키만으로 즉시 커뮤니티 데이터를 가져오세요.
ApiPass가 기본 요청 인프라를 처리하므로 Twitter의 엄격한 엔드포인트별 할당량에 의해 제한되지 않습니다.
기능 플래그와 변수를 포함한 복잡한 GraphQL 쿼리를 작성하는 대신, communityId가 포함된 깔끔한 JSON 페이로드만 전송하면 됩니다.
작업을 제출하고 taskId를 받은 뒤, 선택적으로 callBackUrl을 사용해 결과가 준비되었을 때 알림을 받을 수 있습니다. 대용량 워크로드에 이상적입니다.
rankingMode 매개변수를 통해 관련성 기준으로 정렬된 커뮤니티 트윗을 가져와, 사용자가 기본 X 앱에서 보는 화면과 유사하게 제공합니다.
응답에는 상단 및 하단 커서가 포함되어 있어 대규모 커뮤니티 타임라인을 매우 쉽게 페이지네이션할 수 있습니다.
원시 GraphQL instructions 배열(TimelineClearCache 및 TimelineAddEntries 포함)을 반환하여 Twitter 프론트엔드가 사용하는 정확한 구조를 보존합니다.
count, displayLocation, rankingMode, withCommunity를 사용해 요청을 세밀하게 조정하고 페이로드 크기와 콘텐츠 형태를 제어할 수 있습니다.
커뮤니티 메타데이터, 타임라인 항목, 후속 처리를 위해 바로 사용할 수 있는 커서 토큰이 포함된 완전히 파싱된 resultJson을 받습니다.
특정 관심사의 X 커뮤니티 내 참여도, 인기 게시물, 트렌딩 주제를 추적하세요.
여러 커뮤니티의 최신 게시물을 가져와 뉴스레터나 앱을 위한 통합 피드로 구성하세요.
정책 위반, 스팸 또는 유해 콘텐츠를 탐지하기 위해 커뮤니티 활동을 모니터링하세요.
산업별 커뮤니티(crypto, AI, gaming 등)에서 논의를 추출해 새롭게 떠오르는 트렌드를 감지하세요.
공식 Twitter API는 OAuth 2.0 설정, 고급 액세스 승인, 사용자별 토큰 관리가 필요합니다. ApiPass는 이 모든 과정을 단일 Bearer 토큰으로 대체합니다.
공식 X API v2는 접근 가능한 가격대에서 전용 커뮤니티 타임라인 엔드포인트를 제공하지 않습니다. ApiPass는 이 GraphQL 엔드포인트를 직접 제공하여, 원래라면 엔터프라이즈급 플랜이 필요했을 커뮤니티 데이터에 개발자가 합리적인 비용으로 접근할 수 있게 합니다.
관련 X 커뮤니티 내에서 브랜드나 제품이 어떻게 언급되는지 확인하세요.
경쟁사와 그 사용자들이 활동하는 커뮤니티를 팔로우하여 새로운 기능이나 불만 사항을 파악하세요.
LLM 파인튜닝과 데이터셋 구축을 위해 신호 품질이 높고 주제에 집중된 대화 데이터를 수집하세요.
게시 빈도, 랭킹 변화, 콘텐츠 속도를 측정하여 시간에 따른 커뮤니티 건강도를 벤치마킹하세요.
ApiPass에 가입하고 대시보드에서 Bearer API 키를 생성하세요.
model twitter/graphql/community-tweets-timeline을 사용하여 https://api.apipass.dev/api/v1/jobs/createTask로 POST 요청을 보내고, input.variables 객체 안에 대상 communityId를 전달하세요. 추적을 위한 taskId가 응답으로 반환됩니다.
반환된 taskId를 사용해 https://api.apipass.dev/api/v1/jobs/recordInfo의 recordInfo 엔드포인트를 통해 랭킹 기반 커뮤니티 타임라인을 가져오거나, 처리가 완료되면 결과를 자동으로 받을 수 있도록 callBackUrl을 설정하세요.
모든 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 "count": "number",
9 "displayLocation": "string",
10 "rankingMode": "string",
11 "withCommunity": "boolean"
12 }
13 }
14}model필수string생성에 사용할 모델 이름입니다.
"twitter/graphql/community-tweets-timeline"
callBackUrl선택적string작업 완료 알림을 받을 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체가 실제 이미지 및 동영상 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체에 작업을 자동으로 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구 사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 파라미터가 포함됩니다:
input.variables.communityId필수string1517189118140325888
count선택적number20
displayLocation선택적stringCommunity
rankingMode선택적stringRelevance
withCommunity선택적booleanTrue
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-tweets-timeline",
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입니다.