Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
list-latest-tweets-timeline otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
단일 GraphQL 기반 API 호출로 모든 공개 Twitter List의 최신 트윗 타임라인을 가져옵니다.
ApiPass의 Twitter Graphql List Latest Tweets Timeline API는 개발자가 고유한 listId로 식별되는 특정 Twitter (X) List 멤버들이 게시한 최신 트윗을 가져올 수 있게 해주는 관리형 엔드포인트입니다. Twitter의 내부 GraphQL 인프라를 기반으로 구축되었으며 ApiPass의 통합 createTask / recordInfo 작업 파이프라인을 통해 제공되는 이 API는 트윗 객체, 작성자 메타데이터, 참여 지표, 미디어 첨부 파일이 포함된 구조화된 JSON 타임라인을 반환합니다. Twitter의 인증 흐름, 속도 제한 또는 문서화되지 않은 GraphQL 매개변수를 직접 처리하는 대신, 대상 listId, 선택적 count, includePromotedContent 플래그로 작업을 제출한 뒤 타임라인 데이터가 준비되면 폴링하거나 webhook 콜백으로 받을 수 있습니다.
Twitter의 긴 신청 검토, 프로젝트 승인, 상위 액세스 절차를 건너뛰세요. 단일 ApiPass API key로 인증하고 즉시 리스트 타임라인을 가져오기 시작할 수 있습니다.
이 엔드포인트는 작업을 생성한 뒤 결과를 가져오는 패턴을 따르며, taskId를 즉시 반환하므로 애플리케이션이 오래 걸리는 스크래핑 작업 때문에 블로킹되지 않습니다. 결과는 recordInfo 폴링 또는 선택적 callBackUrl webhook을 통해 전달됩니다.
ApiPass는 실시간 가격 및 안정성 지표를 기반으로 각 요청을 starter, regular, official 제공자에 자동으로 할당하여, 수동 장애 조치 코드 없이도 최소 비용과 안정적인 성능의 균형을 맞춥니다.
Twitter의 비싼 월간 Basic/Pro/Enterprise 등급을 피하세요. 실제로 실행한 list-timeline 작업에 대해서만 비용을 지불하므로 프로토타입과 프로덕션 워크로드 모두에 비용 효율적입니다.
응답은 Twitter의 GraphQL 스키마와 동일한 일관된 resultJson.resultObject.data.list.tweets_timeline 구조로 래핑되므로, 커스텀 HTML/HAR 파서를 작성하지 않고도 통합할 수 있습니다.
모든 작업은 createTime, completeTime, costTime 필드와 함께 수명 주기 상태(waiting, queuing, generating, success, fail)를 제공하여 요청 성능을 완전히 관찰할 수 있게 해줍니다.
선택적 count 매개변수(예: 20)를 사용해 호출당 반환되는 트윗 수를 제어하여, 사용 사례에 맞게 최신성과 페이로드 크기의 균형을 맞출 수 있습니다.
includePromotedContent: false로 전환하면 스폰서/프로모션 트윗을 제외하고 리스트 멤버가 작성한 자연 게시물만으로 구성된 깔끔한 스트림을 받을 수 있습니다.
작업을 생성할 때 callBackUrl을 제공하면 ApiPass가 완료된 타임라인을 사용자의 엔드포인트로 직접 POST하므로 완료 여부를 폴링할 필요가 없습니다.
기자나 업계 전문가의 Lists에서 트윗을 가져와 자체 제품이나 뉴스레터 안에서 실시간 뉴스 피드를 구동할 수 있습니다.
경쟁사 또는 인플루언서 Lists를 모니터링하고 멘션, 해시태그, 트렌드를 발생 즉시 표시합니다.
비공개 팀 큐레이션 List의 최신 트윗을 브로드캐스트하는 Slack, Discord 또는 Telegram 봇을 구축하여 이해관계자에게 최신 정보를 제공할 수 있습니다.
주제별 List 타임라인을 지속적으로 수집하여 LLM 파인튜닝, 감성 분석 또는 학술 연구를 위한 고품질 코퍼스를 구성할 수 있습니다.
ApiPass가 Twitter의 공식 List 타임라인 엔드포인트와 비교해 액세스, 가격, 통합을 어떻게 단순화하는지 확인하세요.
Twitter의 공식 GET /2/lists/:id/tweets 엔드포인트는 첫 호출 전에 유료 Developer Portal 구독, 프로젝트 생성, OAuth 2.0 설정이 필요합니다. ApiPass는 이 모든 과정을 단일 bearer token과 twitter/graphql/list-latest-tweets-timeline으로 설정된 model 필드로 대체하므로, 며칠이 아니라 몇 분 만에 운영을 시작할 수 있습니다.
Twitter의 공식 등급은 엄격한 월간 게시물 한도와 단계별 요금을 부과하며, 월 수천 달러까지 늘어날 수 있습니다. ApiPass는 지능형 제공자 라우팅(auto channel)을 갖춘 작업당 사용량 기반 과금 모델을 사용하므로, 비용은 사용량에 비례해 선형적으로 증가하며 최소 약정이나 예상치 못한 초과 요금이 없습니다.
트레이더, 애널리스트 또는 프로토콜 창립자의 큐레이션된 Lists를 관찰하여 시장을 움직일 수 있는 트윗이 게시되는 즉시 감지합니다.트레이더, 애널리스트 또는 프로토콜 창립자의 큐레이션된 Lists를 관찰하여 시장을 움직일 수 있는 트윗이 게시되는 즉시 감지합니다.
고객, 파트너 또는 비평가의 Lists를 추적하여 브랜드나 제품에 대한 언급을 거의 실시간으로 포착합니다.
편집 List의 최신 게시물을 수동 복사-붙여넣기 없이 CMS, 블로그 사이드바 또는 모바일 앱 피드에 미러링합니다.
경쟁사 계정 List의 트윗을 집계하고 다운스트림 NLP를 실행하여 제품 출시, 채용 공고 또는 PR 캠페인을 추적합니다.
ApiPass에 가입하고 대시보드로 이동한 뒤 bearer token을 생성하세요. Twitter Developer 계정이나 OAuth 핸드셰이크는 필요하지 않습니다. 모든 요청을 인증하는 데 필요한 유일한 자격 증명은 ApiPass key입니다.
model을 twitter/graphql/list-latest-tweets-timeline으로 설정하고 input.variables 객체 안에 대상 listId를 넣어 /api/v1/jobs/createTask로 POST 요청을 보내세요. 반환할 트윗 수를 제한하는 count, 스폰서 게시물을 필터링하는 includePromotedContent, 결과를 webhook으로 받고 싶을 때 사용하는 callBackUrl 같은 선택적 매개변수도 포함할 수 있습니다. ApiPass는 작업을 추적하는 데 사용할 수 있는 taskId로 즉시 응답합니다.
ApiPass가 완료된 타임라인을 callBackUrl로 푸시할 때까지 기다리거나, taskId로 GET /api/v1/jobs/recordInfo를 폴링하세요. 작업 상태가 success로 전환되면 전체 리스트 타임라인이 data.resultJson.resultObject.data.list.tweets_timeline 아래에서 제공되며, 바로 파싱해 애플리케이션에 통합할 수 있습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
List의 최신 트윗 타임라인을 가져옵니다.
이 API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "listId": "string",
8 "count": "number",
9 "includePromotedContent": "boolean",
10 }
11 }
12}model필수string생성에 사용할 모델 이름입니다.
"twitter/graphql/list-latest-tweets-timeline"
callBackUrl선택적string작업 완료 알림을 위한 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체가 실제 이미지 및 비디오 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기준으로 사용 가능한 제공업체에 작업을 자동 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구 사항이 없다면 기본값인 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 파라미터가 포함됩니다:
input.variables.listId필수string44196397
input.variables.count선택적number20
input.variables.includePromotedContent선택적booleanfalse
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/list-latest-tweets-timeline",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "listId": "123",
10 "count": 20,
11 "includePromotedContent": false,
12 }
13 }
14 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공을 의미하며, 그 외 값은 실패를 의미합니다.
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다.
data.taskId작업 상태와 결과를 조회하는 데 사용하는 작업 ID입니다.
