Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
home-latest-timeline otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
단일 GraphQL 기반 API 호출로 인증된 사용자의 최신 홈 타임라인을 실제 역시간순으로 가져옵니다.
ApiPass의 Twitter Graphql Home Latest Timeline API는 Twitter/X 홈 타임라인의 "Following"(Latest) 탭을 가져올 수 있는 비동기 작업 기반 엔드포인트입니다. 이는 인증된 사용자가 팔로우하는 계정의 트윗을 역시간순으로 보여주는 동일한 피드입니다. Twitter의 내부 GraphQL 계층 위에 구축되어 전체 트윗 콘텐츠, 미디어, 참여 지표(좋아요, 리트윗, 답글, 북마크, 조회수), 작성자 프로필 데이터, 프로모션 콘텐츠 플래그, 타임라인 지시사항을 포함한 풍부한 페이로드를 반환합니다. twitter/graphql/home-latest-timeline 모델을 사용해 POST /api/v1/jobs/createTask로 작업을 제출하고, GET /api/v1/jobs/recordInfo를 통해 결과를 조회하며, 작업 완료 시 선택적으로 콜백 전송을 받을 수 있습니다. 역시간순 타임라인 엔드포인트는 사용자의 홈 타임라인에 표시되는 Tweets를 반환하며, 가장 최근 Tweets가 먼저 표시됩니다.
복잡한 X Developer 승인 절차, 프로젝트 설정, OAuth 1.0a/2.0 구성을 건너뛰세요. ApiPass API 키만으로 바로 시작할 수 있습니다.
축약된 v2 REST 응답과 달리, 카드 데이터, 조회수, 대화 제어, 프로모션 메타데이터를 포함해 Twitter 자체 웹 클라이언트가 사용하는 것과 동일한 깊이 있는 객체 구조를 받을 수 있습니다.
channel: auto 파라미터는 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 프로바이더에 작업을 자동으로 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다.
예산과 신뢰성 요구 사항에 맞춰 starter(초저비용), regular(표준, 공식 API보다 훨씬 저렴한 가격), official(최대 안정성을 제공하는 네이티브 Twitter API 가격) 중에서 선택할 수 있습니다.
작업을 제출하면 즉시 taskId를 받고, 결과를 폴링하거나 callBackUrl을 통해 푸시 알림을 받을 수 있어 대량의 논블로킹 워크로드에 적합합니다.
모든 작업은 code, message, state, costTime, resultJson 필드를 포함한 표준화된 래퍼를 반환하므로 오류 처리와 모니터링이 간단합니다.
공식 Twitter/X 클라이언트의 "Latest" 탭과 동일하게, 알고리즘 순위 지정 없이 팔로우한 계정이 게시한 순서 그대로 트윗을 반환합니다.
count를 통해 반환할 트윗 수를 제어하고, includePromotedContent로 프로모션 콘텐츠를 토글하며, latestControlAvailable을 활성화하고, requestContext(예: launch)를 설정해 특정 클라이언트 동작에 맞출 수 있습니다.
각 항목에는 전체 트윗 본문, entities(URL, 멘션), 팔로워 수와 인증 상태가 포함된 작성자 user_results, 참여 카운터, 조회 상태, 출처 표시, TimelineAddEntries 및 TimelineShowCover와 같은 타임라인 지시사항이 포함됩니다.
광고나 알고리즘 재정렬 없이 순수한 시간순 피드를 표시하는 서드파티 리더 앱과 브라우저 확장 프로그램을 지원합니다.
선별된 팔로잉 그래프에서 최신 트윗을 지속적으로 가져와 브랜드 모니터링, PR 또는 경쟁사 추적 대시보드에 제공합니다.
팔로우하는 특정 계정이 대상 키워드를 포함한 새 트윗을 게시할 때마다 알림(Slack, Discord, email, SMS)을 트리거합니다.
팔로잉 피드를 LLM 파이프라인으로 스트리밍하여 요약, 감성 점수화, 주제 클러스터링 또는 개인화된 일일 다이제스트에 활용합니다.
ApiPass가 액세스를 간소화하고, 응답 깊이를 확장하며, Twitter 공식 개발자 플랫폼의 번거로움을 어떻게 제거하는지 확인하세요.
공식 엔드포인트에는 OAuth 1.0a User Context 또는 OAuth 2.0 Authorization Code with PKCE, 그리고 승인된 X Developer 계정과 프로젝트가 필요합니다. ApiPass는 이 전체 흐름을 단일 Bearer token으로 대체합니다. 앱 등록도, OAuth 핸드셰이크도, 갱신해야 하는 사용자 컨텍스트 토큰도 필요 없습니다.
공식 v2 역시간순 홈 타임라인 엔드포인트는 인증된 사용자와 그 사용자가 팔로우하는 계정이 게시한 가장 최근 Tweets 및 Retweets를 반환하지만, 엄격한 속도 제한(15분당 최대 180개 요청, 최대 3,200개 트윗 제한)이 있는 평면화된 REST 형식입니다. ApiPass는 twitter.com에서 사용하는 것과 동일한 Twitter의 네이티브 GraphQL 응답을 프록시하여, v2 REST 엔드포인트가 생략하는 카드 바인딩, 대화 제어, 조회수, 프로모션 메타데이터, 타임라인 커버를 제공합니다. 또한 사용자별 속도 제한이 아니라 ApiPass의 작업 기반 할당량 시스템으로 처리됩니다.
수백 개의 소스를 팔로우하는 기자와 뉴스룸은 매분 최신 게시물을 가져와 트렌드가 되기 전에 속보를 포착할 수 있습니다.
시간에 민감한 거래 신호를 위해 금융 인플루언서 팔로우 목록에서 cashtag 언급과 애널리스트 코멘트를 실제 시간순으로 추적합니다.
여러 브랜드 계정을 관리하는 에이전시는 각 계정의 홈 타임라인을 프로그래밍 방식으로 검토하여 참여할 가치가 있는 대화를 찾아낼 수 있습니다.
정해진 간격으로 타임라인 스냅샷을 수집하여 정의된 팔로우 그래프 전반의 정보 확산, 네트워크 효과 또는 콘텐츠 속도를 연구합니다.
ApiPass에 가입하고 대시보드에서 Bearer token을 생성하세요.
twitter/graphql/home-latest-timeline 모델 식별자를 사용해 /api/v1/jobs/createTask 엔드포인트로 POST 요청을 보내세요. count(가져올 트윗 수), includePromotedContent(광고 토글), latestControlAvailable, requestContext와 같은 입력 변수를 구성합니다. 작업이 완료되는 즉시 ApiPass가 결과를 서버로 푸시하길 원한다면 선택적으로 callBackUrl을 제공하세요.
ApiPass는 즉시 taskId를 반환합니다. 해당 ID를 사용해 /api/v1/jobs/recordInfo 엔드포인트에서 작업 상태를 조회하세요. state 필드가 success로 바뀌면 전체 GraphQL 타임라인 페이로드가 data.resultJson에 제공되며, 트윗 항목, 작성자 프로필, 참여 지표, 타임라인 지시사항을 파싱할 준비가 됩니다. 콜백 URL을 설정했다면 폴링을 완전히 건너뛰고 결과가 도착하는 즉시 처리할 수 있습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
Home Latest 타임라인을 가져옵니다.
API는 다음 구조의 JSON payload를 받습니다:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "count":"number",
8 "includePromotedContent": "boolean",
9 "latestControlAvailable": "boolean",
10 "requestContext": "string",
11 }
12 }
13}model필수string생성에 사용할 모델 이름입니다.
"twitter/graphql/home-latest-timeline"
callBackUrl선택적string작업 완료 알림을 받을 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 provider를 지정할 수 있습니다. 이러한 provider는 실제 이미지 및 동영상 생성 작업을 처리합니다. 현재 APIPASS는 세 가지 provider 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 provider 전반에 작업을 자동 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 별도의 라우팅 요구 사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 파라미터가 포함됩니다:
input.variables.count필수number20
input.variables.includePromotedContent선택적booleanfalse
input.variables.latestControlAvailable선택적booleantrue
input.variables.requestContext선택적stringlaunch
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/home-latest-timeline",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "count": 20,
10 "includePromotedContent": False,
11 "latestControlAvailable": True,
12 "requestContext": "launch",
13 }
14 }
15 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공을, 그 외 값은 실패를 의미합니다.
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다.
data.taskId작업 상태와 결과를 조회하기 위한 작업 ID입니다.
