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-simple 사용 전체 가이드
단일 API 호출로 X (Twitter)의 특정 트윗을 리트윗한 사용자 ID 목록을 가져옵니다.
ApiPass의 Twitter Simple Retweeters API는 지정된 트윗을 리트윗한 사용자 ID를 반환하는 경량 엔드포인트입니다. 대상 tweet_id를 제출하면 개발자는 리트위터 사용자 ID의 깔끔한 배열과 페이지네이션을 위한 next_cursor_str을 함께 받아, 콘텐츠를 확산시킨 모든 계정을 쉽게 열거할 수 있습니다. ApiPass의 통합 비동기 작업 시스템을 기반으로 구축된 이 API는 X 내부 엔드포인트의 복잡성을 추상화하고, 분석 대시보드, 성장 도구 또는 참여 파이프라인에서 직접 사용할 수 있는 구조화된 JSON 결과를 제공합니다.
X 공식 플랫폼에서 요구하는 번거로운 신청, 검토, 승인 절차를 건너뛰세요. ApiPass API 키만 발급받으면 리트위터 데이터를 즉시 가져올 수 있습니다.
필요한 것은 단일 tweet_id뿐입니다. 응답은 간단한 사용자 ID 목록을 반환합니다 — 불필요하게 큰 페이로드나 불필요한 메타데이터 파싱이 없습니다.
ApiPass는 투명한 종량제 모델을 사용하여 공식 X API의 높은 월간 요금제와 프로젝트별 제한을 피할 수 있습니다.
createTask + recordInfo 패턴(선택적 콜백 URL 지원)을 통해 앱을 차단하지 않고도 API를 백그라운드 작업, 큐, 대규모 스크래핑 파이프라인에 쉽게 통합할 수 있습니다.
포함된 next_cursor_str을 사용하면 요청 크기 제한에 걸리지 않고 수만 명의 리트위터가 있는 바이럴 트윗도 페이지 단위로 탐색할 수 있습니다.
ApiPass는 백엔드에서 속도 제한, 토큰 로테이션, 엔드포인트 변경을 처리하므로 X가 내부 API를 업데이트하더라도 통합이 계속 작동합니다.
대상 트윗을 리트윗한 모든 계정을 나타내는 숫자형 사용자 ID(ids)의 깔끔한 배열을 반환합니다.
각 응답에는 next_cursor_str 값이 포함되어 여러 요청에 걸쳐 대규모 리트위터 목록을 원활하게 탐색할 수 있습니다.
POST /api/v1/jobs/createTask를 통해 작업을 제출하고, 선택적으로 callBackUrl을 제공한 뒤 recordInfo를 폴링하거나 작업 완료 시(일반적으로 몇 초 이내) 웹훅을 받을 수 있습니다.
실시간으로 어떤 계정이 트렌딩 트윗을 확산시키는지 모니터링하는 도구를 구축하세요.
특정 니치 또는 특정 크리에이터의 콘텐츠를 꾸준히 리트윗하는 신호 가치가 높은 계정을 식별합니다.
여러 트윗의 리트위터 ID를 교차 참조하여 커뮤니티와 공유 오디언스를 매핑합니다.
리트위터 코호트를 분석하여 의심스러운 리트윗 패턴, 봇 증폭 또는 조직적인 비진정 행위를 탐지합니다.
X의 공식 GET /2/tweets/:id/retweeted_by 엔드포인트는 승인된 개발자 계정, 프로젝트 설정, 의미 있는 사용량을 위한 유료 요금제를 요구합니다. ApiPass는 API 키만 있으면 바로 사용할 수 있습니다 — 신청도, 게이트키핑도 없습니다.
공식 X API는 엄격한 월간 한도(예: Basic tier 제한 및 더 높은 처리량을 위한 고가의 Enterprise 가격)를 부과합니다. ApiPass는 사용량 기준으로 작업당 과금하므로 고정 월간 요금제에 묶이지 않고 리트위터 조회를 유연하게 확장하거나 축소할 수 있습니다.
브랜드 게시물 확산에 도움을 주는 계정을 측정하고, 단순 리트윗 수를 넘어 실제 유기적 도달 범위를 계산합니다.
보상을 배포하기 전에 특정 지갑 연결 계정이 캠페인 게시물을 실제로 리트윗했는지 확인합니다.
경쟁사의 트윗을 꾸준히 부스팅하는 사용자를 분석하여 해당 커뮤니티 구조를 이해합니다.
대규모로 리트위터 그래프를 수집하여 정보 확산 패턴, 에코 챔버, 네트워크 효과를 연구합니다.
ApiPass에 가입하고 대시보드에서 Bearer token을 생성하세요.
model을 twitter/simple/retweeters로 설정하고 input 필드에 대상 tweet_id를 넣어 https://api.apipass.dev/api/v1/jobs/createTask로 POST 요청을 보내세요. 응답으로 taskId를 받게 됩니다.
GET /api/v1/jobs/recordInfo?taskId=...를 호출하거나 callBackUrl이 트리거될 때까지 기다려 리트위터의 ids 배열과 페이지네이션용 next_cursor_str을 가져옵니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
해당 트윗을 리트윗한 사용자 목록을 가져옵니다.
이 API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "tweet_id": "string"
7 }
8}model필수string생성에 사용할 모델 이름입니다.
"twitter/simple/retweeters"
callBackUrl선택적string작업 완료 알림을 받을 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 매개변수를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체는 실제 이미지 및 비디오 생성 작업을 처리합니다. 현재 APIPASS는 세 가지 제공업체 옵션을 제공합니다:
channel 매개변수의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기준으로 사용 가능한 제공업체 간에 작업을 자동으로 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구사항이 없는 한 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 매개변수가 포함됩니다:
input.tweet_id필수stringTwitter 게시물 ID
"1694634492403843248"
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/retweeters",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "tweet_id": "1694634492403843248"
9 }
10 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공을, 그 외 값은 실패를 의미합니다.
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다.
data.taskId작업 상태 및 결과를 조회하는 데 사용하는 작업 ID입니다.
