Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
retweeters otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
단일 API 호출로 공개 트윗을 리트윗한 전체 사용자 목록을 가져오세요.
ApiPass의 Twitter Graphql Retweeters API는 개발자가 X(구 Twitter)에서 특정 트윗을 리트윗한 사용자 목록을 프로그래밍 방식으로 가져올 수 있게 해주는 관리형 엔드포인트입니다. tweetId와 선택적 페이지네이션 및 필터링 매개변수를 제출하면 리트윗한 계정의 구조화된 데이터셋을 받을 수 있어 참여도 분석, 오디언스 조사, 콘텐츠 확산 추적에 이상적입니다. 비동기 작업 모델을 기반으로 구축된 이 API는 백그라운드에서 무거운 작업을 처리합니다. model twitter/graphql/retweeters를 사용해 POST /api/v1/jobs/createTask로 작업을 생성한 뒤, /api/v1/jobs/recordInfo를 통해 폴링하거나 콜백을 받아 결과를 가져옵니다. 이를 통해 애플리케이션이 속도 제한과 장시간 실행되는 요청으로부터 분리되어, 대규모 리트위터 데이터 수집을 간단하고 안정적으로 수행할 수 있습니다.
Twitter 개발자 계정, OAuth 흐름, 순환 자격 증명을 관리할 필요가 없습니다. 단일 ApiPass Bearer API 키로 모든 엔드포인트를 사용할 수 있습니다.
기본 channel: auto 설정은 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체에 각 작업을 배분하여, 최소 비용과 안정적인 성능의 균형을 맞춥니다.
작업을 제출하면 즉시 taskId를 받을 수 있습니다. 시스템이 백그라운드에서 가져오기 작업을 처리하므로, 앱이 느린 업스트림 응답 때문에 차단되지 않습니다.
callBackUrl을 제공하면 작업이 완료되는 즉시 ApiPass가 결과를 서버로 푸시합니다. 폴링이 필요 없습니다.
예산과 SLA 요구 사항에 맞춰 starter(초저가), regular(표준, 공식 가격보다 훨씬 낮음), official(네이티브 Twitter API의 안정성과 속도) 중에서 선택할 수 있습니다.
결과는 간편한 통합을 위해 명확한 작업 수명 주기 상태(waiting, queuing, generating, success, fail)와 함께 깔끔한 JSON 엔벨로프(code, message, data.resultJson)로 반환됩니다.
공개 tweetId(예: 1694634492403843248)를 전달하여 해당 게시물의 리트위터 목록을 가져올 수 있습니다.
count 매개변수(기본값 20)를 사용해 작업당 반환되는 리트위터 레코드 수를 제어하여 속도 또는 완전성에 맞게 최적화할 수 있습니다.
includePromotedContent(boolean)를 전환하여 응답에 프로모션/광고 관련 항목을 포함하거나 제외함으로써 유기적 참여 데이터를 깔끔하게 유지할 수 있습니다.
특정 게시물의 확산을 증폭하는 도달 범위가 큰 계정을 식별하고, 아웃리치 잠재 후보로 선별하세요. 특정 게시물의 확산을 증폭하는 도달 범위가 큰 계정을 식별하고, 아웃리치 잠재 후보로 선별하세요.
시간에 따라 누가 귀하의 콘텐츠 또는 경쟁사의 콘텐츠를 퍼뜨리는지 시각화하세요.
리트위터 목록을 CRM 또는 ML 시스템에 입력하여 유사 오디언스를 구축하고 타기팅을 정교화하세요.
관심 있는 특정 트윗을 주목할 만한 계정이 리트윗할 때마다 알림과 다운스트림 워크플로를 트리거하세요.
Twitter Official API는 리트위터 데이터에 직접 접근할 수 있게 해주지만, 엄격한 개발자 승인, 티어별 사용량 한도, 사용량이 늘어날수록 빠르게 증가하는 고정 가격 등 상당한 장벽이 있습니다. ApiPass는 더 간단한 통합 모델, 유연한 제공업체 라우팅, 크게 낮은 비용으로 동일한 데이터를 제공하는 간소화된 대안을 제공합니다.
Twitter Official API는 승인된 개발자 계정을 요구하며, 리트윗 조회 엔드포인트에 대해 티어별 월간 게시물 한도와 속도 제한을 엄격하게 적용합니다. ApiPass는 이 모든 것을 추상화합니다. API 키로 요청을 보내고 실행한 작업에 대해서만 비용을 지불하면 됩니다.
Twitter Official API가 단일 고정 가격 모델을 제공하는 반면, ApiPass는 작업을 starter, regular, official 채널 전반에 자동으로 라우팅하여 동일한 리트위터 데이터를 훨씬 더 낮은 가격으로 제공합니다. 네이티브 서비스와의 동등성이 필요할 때는 언제든 official을 사용할 수 있습니다.
브랜드 트윗의 확산을 이끈 인플루언서와 커뮤니티가 누구인지 측정하세요.
경쟁사 발표를 누가 리트윗하는지 추적하여 그들의 지지자 네트워크를 파악하세요.
바이럴 또는 민감한 게시물을 확산시키는 계정을 빠르게 나열하여 대응 전략 수립에 활용하세요.
정보 확산, 허위 정보, 네트워크 분석 연구를 위해 구조화된 리트윗 전파 데이터를 수집하세요.
ApiPass에 가입하고 대시보드에서 Bearer 토큰을 생성하세요. 이 단일 키로 모든 엔드포인트를 사용할 수 있으며, Twitter 개발자 계정이나 OAuth 설정이 필요하지 않습니다.
model을 twitter/graphql/retweeters로 설정하고 대상 tweetId와 count, includePromotedContent 같은 선택적 매개변수를 포함해 /api/v1/jobs/createTask로 POST 요청을 보내세요. 결과를 자동으로 받기 위해 callBackUrl도 포함할 수 있습니다. API는 진행 상황을 추적하는 데 사용할 수 있는 taskId를 즉시 반환합니다.
ApiPass가 결과를 callBackUrl로 푸시할 때까지 기다리거나, state 필드가 success가 될 때까지 GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID를 폴링하세요. 전체 리트위터 목록은 data.resultJson.resultObject 안에서 사용할 수 있으며, 애플리케이션에서 바로 소비할 수 있습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
리트윗한 사용자 목록을 가져옵니다
이 API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "tweetId": "string",
8 "count": "number",
9 "includePromotedContent": "boolean",
10 }
11 }
12}model필수string생성에 사용할 모델 이름
"twitter/graphql/retweeters"
callBackUrl선택적string작업 완료 알림을 받을 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체는 실제 이미지 및 비디오 생성 작업을 처리합니다. 현재 APIPASS는 세 가지 제공업체 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화되면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체에 작업을 자동 배분하여 비용 최소화와 안정적인 성능의 균형을 맞춥니다. 별도의 라우팅 요구사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 파라미터가 포함됩니다:
input.variables.tweetId필수string1694634492403843248
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/user-by-screen-name",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "tweetId": "1694634492403843248",
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
