Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
user-media otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
단일 비동기 API 호출로 모든 Twitter 사용자의 전체 미디어 타임라인(사진, 동영상, GIF)을 가져옵니다.
ApiPass의 Twitter Graphql User Media API는 사용자 ID만 제공하면 공개 Twitter (X) 계정의 전체 미디어 타임라인을 가져올 수 있는 관리형 엔드포인트입니다. Twitter의 내부 GraphQL 인프라를 기반으로 구축되어, 대상 사용자가 게시한 모든 사진, 동영상, GIF와 함께 게시 시간, 참여 지표, 미디어 URL 같은 풍부한 메타데이터가 포함된 구조화된 JSON 페이로드를 반환합니다. ApiPass는 이 기능을 비동기 작업 기반 워크플로로 제공합니다. /api/v1/jobs/createTask에 model twitter/graphql/user-media로 요청을 제출하고 taskId를 받은 뒤, /api/v1/jobs/recordInfo를 폴링하거나 callback URL을 등록하여 처리가 완료되면 결과를 받을 수 있습니다. 이 설계는 토큰 관리, 속도 제한, 스크래핑 인프라에 대한 부담을 없애 개발자가 파이프라인 유지관리보다 기능 구축에 집중할 수 있게 해줍니다.
공식 X API의 긴 승인 절차, 엔터프라이즈 페이월, 할당량 제한을 건너뛰세요. 단일 ApiPass API 키만으로 즉시 액세스할 수 있습니다.
기본 auto 채널은 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체 간에 작업을 자동 배분하여, 수동 설정 없이 최소 비용과 안정적인 성능의 균형을 맞춥니다.
예산과 안정성 요구사항에 따라 starter(초저비용), regular(공식 API보다 훨씬 저렴한 표준 티어), official(높은 안정성을 제공하는 네이티브 Twitter API) 중에서 선택할 수 있습니다.
작업을 제출하고 webhook 콜백 또는 폴링으로 결과를 받아, blocking 호출이 비효율적인 대량 배치 처리에 이상적입니다.
미디어 variants, bitrates, dimensions, tweet context를 포함하여 Twitter 자체 웹 클라이언트가 사용하는 것과 동일한 깊게 중첩된 데이터를 반환받을 수 있으며, REST 대안보다 훨씬 더 상세합니다.
성공한 작업에 대해서만 비용을 지불하며, 투명한 비용 구조와 제공업체 간 내장 failover를 통해 공식 티어에서 흔히 발생하는 예상치 못한 초과 청구를 없앱니다.
count 파라미터를 사용해 최신 미디어 항목 몇 개부터 대량 배치까지 단일 요청으로 가져와, 최신성 또는 커버리지에 맞게 최적화할 수 있습니다.
includePromotedContent, withBirdwatchNotes, withVoice, withClientEventToken, withV2Timeline 같은 필드를 토글하여 특정 데이터 레이어를 포함하거나 제외함으로써 페이로드를 가볍고 관련성 있게 유지할 수 있습니다.
모든 작업은 waiting, queuing, generating, success, fail과 같은 명확한 라이프사이클 상태를 제공하므로, 애플리케이션이 처리 진행 상황에 지능적으로 반응하고 오류를 원활하게 처리할 수 있습니다.
수동 업로드 없이 포트폴리오 웹사이트, 팬 페이지, 개인 브랜드 허브에 크리에이터의 전체 시각 콘텐츠 피드를 자동으로 가져와 선보일 수 있습니다.
경쟁사 또는 파트너 브랜드의 미디어 게시물을 분석 플랫폼에 지속적으로 동기화하여 시각적 감성 분석과 캠페인 분석에 활용할 수 있습니다.
공개 Twitter 계정에서 대규모 주제 중심 이미지 및 동영상 데이터셋을 직접 수집하여 컴퓨터 비전 또는 멀티모달 모델을 파인튜닝할 수 있습니다.
인플루언서, 기자, 틈새 커뮤니티의 최신 시각 콘텐츠를 노출하는 뉴스피드 앱, 무드보드, 트렌드 탐지 플랫폼을 구동할 수 있습니다.
접근성, 비용, 데이터 풍부함 측면에서 ApiPass의 User Media 엔드포인트가 Twitter 공식 API와 어떻게 비교되는지, 그리고 개발자들이 전환하는 이유를 확인해 보세요.
공식 Twitter API v2 /users/:id/tweets 엔드포인트에서 media expansions를 사용하려면 유료 개발자 계정이 필요하며, Basic 티어만 해도 월 $200의 비용과 엄격한 월별 게시물 한도가 있습니다. ApiPass의 User Media 엔드포인트는 Twitter 승인이 필요 없고 작업 단위로 과금되며, 여전히 네이티브 API 수준의 안정성을 원하는 사용자를 위해 경쟁력 있는 가격의 official 채널도 제공합니다.
Twitter의 공식 REST API는 깔끔한 미디어 타임라인을 구성하기 위해 여러 expansion 파라미터와 includes.media 배열 조합이 필요합니다. ApiPass는 기반이 되는 GraphQL UserMedia 작업을 직접 노출하여 Twitter 자체 웹 클라이언트가 사용하는 것과 동일한 밀도 높고 사전 결합된 구조를 반환합니다. 여기에는 v2 timeline modules, voice metadata, Birdwatch notes가 포함되며, 모두 간단한 boolean 플래그로 토글할 수 있습니다.
파트너십 체결 전에 인플루언서의 시각 콘텐츠 이력을 감사하여 브랜드 적합성, 게시 주기, 참여 품질을 평가할 수 있습니다.
계정 손실 또는 플랫폼 변경에 대비해 Twitter 미디어의 지속 가능한 기록이 필요한 기자, 공인, 조직을 위한 자동 백업 시스템을 구축할 수 있습니다.
조사관과 기자는 긴급 사건 발생 시 주요 계정의 미디어 증거를 체계적으로 가져와 타임스탬프와 메타데이터와 함께 시각적 맥락을 보존할 수 있습니다.
브랜드는 제품이 태그된 고객 또는 앰배서더 미디어를 가져와 쇼핑 가능한 갤러리, 리뷰 페이지, 소셜 프루프 위젯에 활용할 수 있습니다.
ApiPass에 가입하고 대시보드에서 Bearer token을 생성하면 모든 요청을 인증할 준비가 완료됩니다.
POST를 /api/v1/jobs/createTask로 보내고 "model": "twitter/graphql/user-media", 대상 userId(예: "44196397"), 그리고 count 또는 withV2Timeline 같은 선택적 플래그를 포함하세요. 응답으로 즉시 taskId를 받게 됩니다.
state가 success가 될 때까지 GET /api/v1/jobs/recordInfo?taskId=...를 폴링하거나, 작업 생성 시 callBackUrl을 제공하여 생성이 완료되는 즉시 ApiPass가 완료된 resultJson을 서버로 직접 푸시하도록 할 수 있습니다.
모든 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입니다
