Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
user-tweets otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
단일 API 호출로 모든 Twitter 사용자가 게시한 트윗의 전체 타임라인을 가져옵니다.
ApiPass의 Twitter Graphql User Tweets API는 개발자가 사용자 ID만 제공하면 공개 Twitter (X) 사용자의 트윗 타임라인을 가져올 수 있는 강력한 엔드포인트입니다. Twitter의 내부 GraphQL 인프라를 기반으로 구축된 이 API는 원본 게시물, 답글, 리트윗, 미디어 첨부파일, 참여 지표, 타임라인 메타데이터를 포함한 풍부하고 구조화된 트윗 데이터를 반환합니다. ApiPass는 Twitter GraphQL 계층의 복잡성을 깔끔한 비동기 작업 기반 REST 인터페이스로 래핑합니다. 대상 userId와 선택적 페이지네이션 파라미터를 포함해 /api/v1/jobs/createTask로 요청을 제출하고 taskId를 받은 다음, /api/v1/jobs/recordInfo를 통해 전체 타임라인 결과를 조회할 수 있습니다. 스마트 제공자 라우팅, 선택적 웹훅 콜백, 다양한 채널 등급(starter, regular, official, auto)을 통해 ApiPass는 OAuth 토큰, 속도 제한 또는 스크래핑 인프라를 직접 관리하지 않고도 사용자 타임라인 데이터를 애플리케이션에 손쉽게 통합할 수 있게 해줍니다.
긴 승인 절차와 OAuth 설정을 건너뛰세요. ApiPass API 키를 생성하고 간단한 Bearer 토큰으로 즉시 사용자 타임라인을 가져오기 시작할 수 있습니다.
기본 channel: auto 설정은 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공자에 작업을 자동 배분하여, 최소 비용과 안정적인 성능의 균형을 맞춥니다.
starter(초저가), regular(공식 API 가격보다 훨씬 낮은 표준 등급), official(Twitter 네이티브 API로 최대 안정성 제공) 중에서 선택하여 안정성 요구사항에 맞게 지출을 조정할 수 있습니다.
작업 기반 설계(createTask → recordInfo)는 장시간 실행되는 요청을 안정적으로 처리하여 클라이언트 측 타임아웃을 없애고 신뢰할 수 있는 대량 처리를 가능하게 합니다.
선택적으로 callBackUrl을 제공하면 작업 처리가 완료되는 즉시 자동 알림을 받을 수 있어 비효율적인 폴링 루프가 필요 없습니다.
withVoice, withV2Timeline, withQuickPromoteEligibilityTweetFields, includePromotedContent와 같은 boolean 플래그를 사용해 응답 페이로드를 세밀하게 조정하고 필요한 데이터만 정확히 받을 수 있습니다.
공개 Twitter userId(예: 44196397)와 count 파라미터를 전달하면 모든 네이티브 GraphQL 메타데이터가 포함된 페이지네이션된 트윗 배치를 가져올 수 있습니다.
모든 작업은 실시간 상태 전환(waiting → queuing → generating → success / fail)을 노출하며, 성능 모니터링을 위한 createTime, completeTime, costTime 필드도 함께 제공합니다.
결과는 Twitter의 네이티브 GraphQL 응답을 반영하는 깔끔한 resultJson.resultObject 구조로 제공되어 파싱과 후속 처리가 간단합니다.
주요 인플루언서, 경쟁사 또는 브랜드 계정의 트윗을 지속적으로 가져와 실시간 모니터링 대시보드를 구동할 수 있습니다.
컴플라이언스 또는 역사적 참고를 위해 미디어와 참여 통계를 포함한 전체 타임라인을 보존하는 개인 또는 조직용 트윗 아카이버를 구축할 수 있습니다.
특정 사용자로부터 대규모의 구조화된 트윗 데이터셋을 수집하여 LLM, 감성 분류기 또는 추천 시스템을 파인튜닝할 수 있습니다.
크리에이터와 마케터에게 본인 또는 경쟁 계정의 상세한 타임라인 인사이트, 게시 패턴, 참여도 분석을 제공할 수 있습니다.
비용, 접근성, 통합 노력 측면에서 ApiPass가 Twitter의 네이티브 개발자 플랫폼과 어떻게 비교되는지 확인하세요.
Twitter의 공식 GET /2/users/:id/tweets 엔드포인트는 엄격한 월간 한도와 수동 승인 절차가 있는 유료 Developer 계정(Basic 등급 이상)을 필요로 합니다. ApiPass는 이 장벽을 완전히 없앱니다. 가입하고 API 키를 받은 뒤 공식 API보다 훨씬 낮은 요금으로 작업 단위 결제를 하면 되며, 공식 API와 동등한 수준의 안정성이 필요할 때는 official 채널을 사용할 수 있습니다.
공식 API는 OAuth 2.0 설정, bearer 토큰 관리, 페이지네이션 커서 처리, 세심한 속도 제한 추적이 필요합니다. ApiPass는 이를 간단한 2단계 작업 패턴(createTask + recordInfo)과 선택적 웹훅으로 대체합니다. 단일 API 키 외의 인증 흐름이 필요 없으며, 사용자 측에서 유지해야 할 속도 제한 로직도 없습니다.
경쟁 브랜드 계정을 추적하여 콘텐츠 게시 빈도, 메시징 전략, 오디언스 참여 패턴을 파악할 수 있습니다.
마케팅 에이전시는 계약 체결 전에 과거 트윗 데이터를 가져와 인플루언서의 게시 일관성, 콘텐츠 품질, 오디언스 상호작용을 검증할 수 있습니다.
영향력 있는 트레이더, 프로젝트 창립자 또는 애널리스트의 트윗을 집계하여 자동 거래 신호와 시장 심리 모델에 활용할 수 있습니다.
연구자와 기자는 담론 분석, 허위정보 연구 또는 탐사보도를 위해 공인의 트윗 타임라인을 수집할 수 있습니다.
ApiPass에 가입하고 대시보드에서 Bearer API 키를 생성하세요. 이 단일 키로 모든 요청을 인증할 수 있습니다. OAuth 흐름, 개발자 계정 승인, 토큰 갱신 로직이 필요 없습니다.
model을 twitter/graphql/user-tweets로 설정하고 대상 userId와 원하는 count를 포함하여 https://api.apipass.dev/api/v1/jobs/createTask로 POST 요청을 보내세요. includePromotedContent, withVoice, withV2Timeline, withQuickPromoteEligibilityTweetFields와 같은 boolean 플래그를 사용해 응답 페이로드를 세밀하게 조정할 수 있습니다. 선택적으로 callBackUrl을 포함하면 작업이 완료되는 즉시 푸시 알림을 받을 수 있습니다. API는 추적을 위한 고유한 taskId를 반환합니다.
반환된 taskId를 사용해 GET /api/v1/jobs/recordInfo?taskId=....를 조회하세요. state 필드가 waiting, queuing, generating을 거쳐 전환되는 과정을 모니터링합니다. 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 // Input parameters
7 }
8}model필수string생성에 사용할 모델 이름입니다
"twitter/simple/user-tweets"
callBackUrl선택적string작업 완료 알림을 받을 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체가 실제 이미지 및 비디오 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체 전반에 작업을 자동 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구 사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 파라미터가 포함됩니다:
input.user_id필수string사용자 ID
최상의 결과를 위해 주제, 스타일, 조명, 구도를 설명하세요
44196397
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/simple/user-tweets",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "user_id": "44196397"
9 }
10 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공을 의미하며, 그 외 값은 실패를 의미합니다
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다
data.taskId작업 상태와 결과를 조회하기 위한 작업 ID입니다
