Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
tweet-detail otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
단일 tweet ID로 콘텐츠, 참여 지표, 답글, 대화 맥락을 포함한 전체 트윗 상세 정보를 가져옵니다.
ApiPass의 Twitter Graphql Tweet Detail API는 개발자가 고유한 tweet ID를 사용해 X(이전 Twitter)의 모든 공개 트윗에 대한 포괄적인 정보를 가져올 수 있게 해주는 강력한 엔드포인트입니다. ApiPass의 통합 작업 시스템을 통해 twitter/graphql/tweet-detail 모델을 호출하면 트윗 텍스트, 작성자 정보, 미디어 첨부 파일, 참여 통계(likes, retweets, replies, views), 대화 스레드, 인용 트윗, 커뮤니티 노트(Birdwatch), 풍부한 아티클 콘텐츠가 포함된 구조화된 JSON 데이터를 받을 수 있습니다. 이 API는 Twitter의 내부 GraphQL 스키마를 활용하여 기존 REST 엔드포인트에서 제공되는 것보다 훨씬 더 풍부한 데이터 필드에 접근할 수 있게 하며, 동시에 인증 복잡성, 프록시 관리, 속도 제한 처리를 추상화합니다.
Twitter 공식 API 티어의 긴 승인 절차를 건너뛰세요. ApiPass API key만으로 즉시 시작할 수 있습니다.
단일 요청으로 Birdwatch 노트, 음성 트윗, 커뮤니티 맥락, 아티클 리치 콘텐츠, 전체 대화 스레드를 포함한 Graphql 수준의 필드에 접근할 수 있습니다.
기본 channel: auto 설정은 실시간 가격 및 안정성 지표를 기반으로 프로바이더 전반에 작업을 자동 할당하여 비용 효율성과 신뢰성을 모두 보장합니다.
프로젝트의 구체적인 요구 사항에 따라 예산과 성능의 균형을 맞추기 위해 starter, regular 또는 official 티어 중에서 선택하세요.
작업을 제출하면 즉시 task ID를 받고, 결과를 폴링하거나 ApiPass가 완료된 데이터를 webhook URL로 푸시하도록 할 수 있습니다.
withCommunity, withBirdwatchNotes, withVoice, withArticlePlainText 같은 boolean 플래그를 사용해 응답 페이로드를 정밀하게 조정하고 필요한 데이터만 가져오세요.
중심 트윗뿐 아니라 전체 답글 트리, 인용 트윗, 상위 스레드까지 가져올 수 있어 대화 뷰어나 감정 분석기를 구축하는 데 적합합니다.
리치 콘텐츠 상태와 일반 텍스트 추출을 위한 전용 토글로 포함된 이미지, 동영상, 음성 노트, 장문 아티클 콘텐츠를 추출합니다.
트윗에 첨부된 맥락 기반 팩트체크와 커뮤니티 기여 노트를 가져와 애플리케이션에 내장된 신뢰도 신호를 제공합니다.
블로그, 뉴스 사이트 또는 채팅 애플리케이션을 위한 맞춤형 트윗 미리보기 위젯과 임베드 카드를 구동합니다.
답글 체인을 매핑하고, 토론의 핵심 영향력자를 식별하며, 참여 흐름을 시각화하는 도구를 구축합니다.
저널리즘, 연구 또는 법적 문서화를 위해 중요한 트윗과 전체 답글 맥락을 영구적이고 검색 가능한 아카이브로 만듭니다.
참여 지표가 포함된 구조화된 트윗 데이터를 LLM 파인튜닝 워크플로 또는 감정 분류 모델에 공급합니다.
접근 장벽, 가격, 데이터 깊이 측면에서 ApiPass가 Twitter 공식 API와 어떻게 비교되는지, 그리고 개발자들이 전환하는 이유를 확인하세요.
Twitter 공식 v2 API는 엄격한 월간 트윗 한도와 애플리케이션 검토 절차가 있는 유료 개발자 구독이 필요합니다. ApiPass는 API key만 필요하며, 성공한 작업 단위로 과금하고, 예산에 민감한 프로젝트를 위해 초저가 티어의 starter 채널을 제공합니다.
공식 GET /2/tweets/:id 엔드포인트는 선택된 확장 정보가 포함된 평면 객체를 반환합니다. ApiPass의 GraphQL 엔드포인트는 Twitter 자체 내부 데이터 구조를 반영하여 Birdwatch 노트, 커뮤니티 맥락, V2 타임라인 모듈, 빠른 프로모션 적격성 플래그처럼 공개 REST API로는 사용할 수 없는 중첩 필드를 노출합니다.
브랜드 또는 업계를 언급하는 영향력 높은 트윗을 추적하고, 전체 대화 스레드를 가져와 실시간으로 대중의 감정을 파악합니다.
탐사 보도 기자는 출처 검증과 인용을 위해 완전한 답글 맥락, 커뮤니티 노트, 메타데이터가 포함된 트윗을 캡처할 수 있습니다.
마케팅 플랫폼은 스폰서 트윗이 게시되어 있는지 검증하고, 시간에 따른 참여 증가를 측정하며, 커뮤니티 노트 상태를 확인할 수 있습니다.
전체 대화 계층을 추출하여 바이럴 Twitter 스레드를 구조화된 아티클이나 학습 자료로 변환하는 플랫폼을 구축합니다.
ApiPass에 가입하고 대시보드로 이동한 다음 인증을 위한 Bearer token을 생성하세요. 이 단일 키로 별도의 Twitter Developer account 없이 모든 ApiPass 엔드포인트에 접근할 수 있습니다.
model을 twitter/graphql/tweet-detail로 설정하고 input.variables 객체 안에 대상 focalTweetId를 포함하여 /api/v1/jobs/createTask로 POST 요청을 보내세요. withCommunity, withBirdwatchNotes 또는 withVoice 같은 토글을 활성화하여 응답을 추가로 사용자 지정할 수 있으며, 선택적으로 callBackUrl을 제공해 webhook을 통해 결과를 받을 수 있습니다. API는 추적을 위한 taskId를 즉시 반환합니다.
반환된 taskId를 사용해 /api/v1/jobs/recordInfo를 조회하세요. 엔드포인트를 폴링하거나 콜백이 실행될 때까지 기다리세요. state 필드가 success를 반환하면 resultJson.resultObject를 파싱하여 콘텐츠, 참여 지표, 답글, 대화 맥락을 포함한 전체 트윗 상세 페이로드에 접근할 수 있습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
트윗 상세 정보 가져오기
이 API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "focalTweetId": "string",
8 "referrer": "string",
9 "controller_data": "string",
10 "with_rux_injections": "boolean",
11 "includePromotedContent": "boolean",
12 "withCommunity": "boolean",
13 "withQuickPromoteEligibilityTweetFields": "boolean",
14 "withBirdwatchNotes": "boolean",
15 "withVoice": "boolean",
16 "withV2Timeline": "boolean",
17 },
18 "fieldToggles": {
19 "withArticleRichContentState": "boolean",
20 "withArticlePlainText": "boolean",
21 },
22 }
23}model필수string생성에 사용할 모델 이름
"twitter/graphql/tweet-detail"
callBackUrl선택적string작업 완료 알림을 위한 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 매개변수를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체는 실제 이미지 및 비디오 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다:
channel 매개변수의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체에 작업을 자동으로 할당하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구 사항이 없는 한 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
입력 객체에는 다음 매개변수가 포함됩니다:
input.variables.focalTweetId필수string1694634492403843248
input.variables.referrer선택적stringprofile
input.variables.controller_data선택적stringDAACDAABDAABCgABAAAAAAAAAAAKAAkAAAABFPY0+AAAAAA=
input.variables.with_rux_injections선택적booleanfalse
input.variables.includePromotedContent선택적booleanfalse
input.variables.withCommunity선택적booleantrue
input.variables.withQuickPromoteEligibilityTweetFields선택적booleantrue
input.variables.withBirdwatchNotes선택적booleantrue
input.variables.withVoice선택적booleantrue
input.withV2Timeline.withVoice선택적booleantrue
input.fieldToggles.withArticleRichContentState선택적booleantrue
input.fieldToggles.withArticlePlainText선택적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/user-by-screen-name",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "focalTweetId": "1694634492403843248",
10 "referrer": "profile",
11 "controller_data": "DAACDAABDAABCgABAAAAAAAAAAAKAAkAAAABFPY0+AAAAAA=",
12 "with_rux_injections": false,
13 "includePromotedContent": false,
14 "withCommunity": true,
15 "withQuickPromoteEligibilityTweetFields": true,
16 "withBirdwatchNotes": true,
17 "withVoice": true,
18 "withV2Timeline": true,
19 },
20 "fieldToggles": {
21 "withArticleRichContentState": true,
22 "withArticlePlainText": true,
23 }
24 }
25 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공, 그 외는 실패를 의미합니다.
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다.
data.taskId작업 상태 및 결과를 조회하기 위한 작업 ID
