Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
tweet-result-by-rest-id otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
단일 tweet ID를 전달하여 텍스트, 미디어, 참여 지표, 메타데이터를 포함한 전체 트윗 데이터를 가져옵니다.
ApiPass의 Twitter Graphql Tweet Result By Rest Id API는 개발자가 고유한 tweet ID(rest_id)만으로 모든 공개 트윗의 전체 페이로드를 가져올 수 있게 해주는 GraphQL 기반 엔드포인트입니다. ApiPass의 통합 작업 시스템에 간단한 POST 요청을 보내면 트윗 텍스트, 작성자 정보, 미디어 첨부 파일(이미지, 동영상, GIF), 참여 통계(좋아요, 리트윗, 답글, 인용 수), Birdwatch 주석, 대화 맥락 등을 확인할 수 있습니다. Twitter의 내부 GraphQL 스키마를 그대로 반영하므로 OAuth 흐름, rate-limit 한도, 엔터프라이즈 가격 티어를 관리하는 복잡함 없이 Twitter의 자체 웹 클라이언트가 사용하는 것과 동일한 풍부하고 구조화된 데이터를 제공합니다.
긴 신청, 승인, elevated-access 절차를 건너뛰세요. ApiPass API 키만 발급받으면 몇 분 안에 트윗을 가져오기 시작할 수 있습니다.
Twitter의 월 $5,000+ 엔터프라이즈 티어를 피하세요. ApiPass는 성공한 작업당 과금하므로 인디 개발자와 성장 중인 스타트업 모두에게 실용적입니다.
기본 auto 채널은 실시간 가격과 안정성을 기준으로 각 요청을 starter, regular, official 제공업체에 자동 할당하여 비용과 신뢰성을 균형 있게 맞춰줍니다.
미디어 변형, 동영상 비트레이트, 대화 ID, 편집 가능 플래그를 포함해 Twitter의 네이티브 프론트엔드가 사용하는 것과 동일한 종합 데이터를 가져오세요. 축소된 v2 REST 응답에 그치지 않습니다.
작업을 제출하고 taskId를 받은 뒤 recordInfo를 폴링하거나, callBackUrl을 제공하여 처리가 완료되면 결과를 받을 수 있습니다. 배치 워크플로와 서버리스 함수에 이상적입니다.
withHighlightedLabel, withTweetQuoteCount, withBirdwatchPivots, withVoice, withReactions 같은 선택 플래그를 전환하여 필요한 필드만 가져오고 페이로드를 가볍게 유지하세요.
전체 legacy 필드, entities, extended_entities, 대화 스레드 ID, 원본 GraphQL __typename을 반환하여 full_text부터 display_text_range까지 모든 정보를 제공합니다.
HLS 스트림, 다양한 비트레이트(288k / 832k / 2176k)의 MP4 렌디션, 화면 비율, 재생 시간, 썸네일, 포커스 사각형, 수익화 상태 등 모든 미디어 변형을 포함합니다.
요청 시점에 Twitter의 GraphQL 레이어에서 직접 실시간 favorite_count, retweet_count, reply_count, quote_count 값을 가져옵니다.
전체 미디어와 참여 데이터를 활용해 웹사이트, 뉴스레터 또는 메시징 앱에서 Twitter의 네이티브 카드 미리보기를 재현하세요.
브랜드, 인플루언서 또는 마케팅 캠페인을 위해 특정 트윗의 성과를 시간 경과에 따라 추적하세요.
법적 증거, 저널리즘, 팩트체킹 플랫폼 또는 연구 데이터셋을 위해 트윗 스냅샷을 저장하세요.
구조화된 트윗 데이터를 LLM 파인튜닝 워크플로, 감성 분석 모델 또는 트렌드 감지 시스템에 공급하세요.
ApiPass의 GraphQL 기반 트윗 조회가 접근성, 가격, 데이터 깊이 측면에서 Twitter의 공식 v2 REST 엔드포인트와 어떻게 비교되는지 확인하세요.
Twitter의 공식 GET /2/tweets/:id는 월 $200부터 시작하는 유료 티어(Basic)와 프로덕션 규모에서는 엔터프라이즈 수준까지 올라가는 Developer 계정이 필요합니다. ApiPass는 Twitter 승인이 필요 없으며 starter, regular, official 채널을 통해 투명한 작업당 과금 방식을 사용합니다.
Twitter의 v2 REST API는 평탄화된 opt-in 필드 스키마를 반환하므로 완전한 그림을 구성하려면 여러 expansions와 tweet.fields 파라미터가 필요합니다. ApiPass는 legacy entities, 동영상 변형, Birdwatch pivots, 대화 메타데이터를 포함한 전체 GraphQL tweetResult.result 객체를 단일 응답으로 반환합니다.
뉴스룸과 OSINT 팀은 속보에서 인용된 개별 트윗을 가져와 콘텐츠를 검증하고, 특정 시점의 참여도를 캡처하며, 삭제되기 전에 미디어를 아카이브합니다.
마케팅 플랫폼은 제품에 대한 특정 바이럴 트윗을 자세히 분석하여 감성을 좌우하는 인용문, 미디어 자산, 도달 지표를 추출합니다.
에이전시는 출처에서 직접 확인한 리트윗, 좋아요, 답글, 인용 수를 기반으로 스폰서 트윗 성과를 보고합니다.
로펌과 컴플라이언스 팀은 소송, 게시 중단 분쟁 또는 규제 신고를 위해 변경 불가능한 트윗 스냅샷(동영상 변형 및 타임스탬프 포함)을 가져옵니다.
apipass.dev에서 ApiPass 계정을 만들고 대시보드에서 Bearer token을 생성하세요.
model twitter/graphql/tweet-result-by-rest-id, input.variables의 대상 tweetId, withTweetQuoteCount 또는 withBirdwatchPivots 같은 선택 플래그를 포함하여 /api/v1/jobs/createTask로 POST 요청을 보내세요. 결과를 자동으로 받으려면 선택적으로 callBackUrl을 포함할 수 있습니다.
반환된 taskId를 사용해 GET /api/v1/jobs/recordInfo?taskId=...를 호출하고 state를 확인하세요. state가 success가 되면 resultJson.resultObject.data.tweetResult.result를 파싱하여 전체 트윗 페이로드에 접근할 수 있습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
tweetId로 트윗 결과 가져오기
이 API는 다음 구조의 JSON 페이로드를 받습니다.
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "tweetId": "string",
8 "withHighlightedLabel": "boolean",
9 "withTweetQuoteCount": "boolean",
10 "includePromotedContent": "boolean",
11 "withBirdwatchPivots": "boolean",
12 "withVoice": "boolean",
13 "withReactions": "boolean",
14 }
15 }
16}model필수string생성에 사용할 모델 이름입니다.
"twitter/graphql/tweet-result-by-rest-id"
callBackUrl선택적string작업 완료 알림을 받을 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이 제공업체들은 실제 이미지 및 동영상 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다.
channel 파라미터의 기본값은 auto입니다. 활성화되면 APIPASS가 실시간 가격 및 안정성 지표를 기준으로 사용 가능한 제공업체에 작업을 자동 할당하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 별도의 라우팅 요구사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 파라미터가 포함됩니다.
input.variables.tweetId필수string1694513603251241143
input.variables.withHighlightedLabel선택적booleantrue
input.variables.withTweetQuoteCount선택적booleantrue
input.variables.includePromotedContent선택적booleantrue
input.variables.withBirdwatchPivots선택적booleantrue
input.variables.withVoice선택적booleantrue
input.variables.withReactions선택적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 "tweetId": "1694513603251241143",
10 "withHighlightedLabel": true,
11 "withTweetQuoteCount": true,
12 "includePromotedContent": true,
13 "withBirdwatchPivots": true,
14 "withVoice": true,
15 "withReactions": true,
16 }
17 }
18 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공, 그 외는 실패를 의미합니다.
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다.
data.taskId작업 상태와 결과를 조회하기 위한 작업 ID입니다.
