Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
followers otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
한 번의 API 호출로 모든 공개 Twitter (X) 계정의 전체 팔로워 목록을 가져오세요 — OAuth도, 개발자 승인도, rate-limit로 인한 번거로움도 없습니다.
ApiPass의 Twitter Graphql Followers API는 Twitter의 내부 GraphQL 계층에 직접 연결되어 모든 공개 X 계정의 팔로워를 반환하는 관리형 엔드포인트입니다. model twitter/graphql/followers와 함께 target userId를 /api/v1/jobs/createTask 엔드포인트로 제출하면 taskId를 받게 되며, 이를 폴링하거나 webhook callback으로 전달받아 각 팔로워의 프로필 메타데이터가 포함된 풍부한 JSON 페이로드를 가져올 수 있습니다 — screen name, bio, follower/following counts, verification status, profile images, creation date 등이 포함됩니다. 2026년 2월 6일에 기본 방식으로 pay-per-use를 도입해 API 요청마다 크레딧을 부과하고 복잡한 OAuth 흐름을 요구하는 공식 X API와 달리, ApiPass는 모든 과정을 간단한 bearer-token REST 호출 뒤에 래핑하므로 몇 분 안에 팔로워 데이터 내보내기를 시작할 수 있습니다.
Twitter의 여러 단계 앱 리뷰와 키 로테이션 프로세스를 건너뛰세요. 단일 Authorization: Bearer YOUR_API_KEY 헤더로 인증하고 즉시 팔로워 데이터를 가져오기 시작할 수 있습니다.
공식 X API는 리소스별로 상당한 요금을 부과하며, pay-per-use에는 월 2백만 post reads라는 엄격한 한도가 있습니다. 이를 초과하면 X는 월 $42,000부터 시작하는 Enterprise 요금제로 전환하도록 요구합니다. ApiPass는 요청을 가장 비용 효율적인 provider로 자동 라우팅합니다.
기본 channel: auto 설정은 가격과 안정성을 기준으로 사용 가능한 provider에 각 task를 실시간으로 할당하므로, 라우팅 로직을 직접 작성하지 않아도 비용과 신뢰성의 최적 균형을 얻을 수 있습니다.
task를 제출하고 taskId를 받은 뒤, /api/v1/jobs/recordInfo를 폴링하거나 작업이 완료되면 callBackUrl에서 callback을 받을 수 있습니다. 동기 요청이라면 타임아웃될 수 있는 대량 팔로워 내보내기에 적합합니다.
user_results.result.legacy 필드, professional profile data, is_blue_verified 플래그, affiliate badges 등 Twitter의 자체 클라이언트가 보는 완전한 원시 timeline 구조를 받습니다 — 공식 v2 REST API가 종종 제거하거나 expansion parameters 뒤에 숨기는 필드까지 포함됩니다.
초저비용 대량 작업에는 starter, 균형 잡힌 프로덕션 워크로드에는 regular, Twitter의 네이티브 API와 동일한 안정성과 속도가 필요할 때는 official을 선택하세요 — 모두 단일 통합 엔드포인트 뒤에서 제공됩니다.
각 팔로워 항목은 전체 TimelineUser 객체를 반환합니다: rest_id, screen_name, name, description, followers_count, friends_count, statuses_count, created_at, profile_image_url_https, profile_banner_url, verification status, pinned tweet IDs, professional category metadata.
input.variables.count 매개변수로 task당 가져올 팔로워 레코드 수를 제어할 수 있으며, 필수 필드는 userId뿐입니다. includePromotedContent를 전환해 promoted entries를 결과에서 제외할 수 있습니다.
모든 job은 waiting, queuing, generating, success, fail과 같은 명확한 상태를 createTime, completeTime, costTime 필드와 함께 제공하므로, 성능을 모니터링하고 실패 사유를 사용자에게 직접 표시할 수 있습니다.
크리에이터, 브랜드 또는 경쟁사의 팔로워 성장, 오디언스 인구통계, 인증 팔로워 비율, 인플루언서 중복도를 시각화하세요.
관련 업계 계정의 팔로워를 가져와 bio 키워드와 follower count로 점수를 매기고, 적격 잠재 고객을 영업 파이프라인으로 푸시하세요.
캠페인용 크리에이터를 발굴하기 위해 대상 계정의 high-signal 팔로워(verified, 큰 followers_count, niche professional categories)를 식별하세요.
감성 분석, 커뮤니티 탐지, 또는 공인과 주제 주변에서 오디언스가 어떻게 변화하는지에 대한 종단 연구를 위해 팔로워 네트워크를 내보내세요.
가격, 접근 요구사항, 응답의 풍부함 측면에서 ApiPass가 Twitter 공식 API와 어떻게 비교되는지, 그리고 대부분의 개발자가 ApiPass로 더 빠르게 출시하는 이유를 확인하세요.
공식 X API는 pay-per-use 크레딧 시스템으로 운영되며, owned reads — 게시물, 북마크, 팔로워, 리스트처럼 자체 데이터에 대해 자체 개발자 앱이 수행하는 요청 — 는 리소스당 $0.001로 책정됩니다. 하지만 다른 계정의 팔로워를 가져오려면 훨씬 더 비싼 standard (non-owned) read pricing과 유료 티어 구독이 필요합니다. ApiPass는 월 구독 최저 요금도, 개발자 승인 게이트도, 2M-read 한도도 없습니다 — task별로 결제하며 첫날부터 모든 공개 계정을 대상으로 지정할 수 있습니다.
공식 v2 REST API는 더 풍부한 데이터를 얻기 위해 expansion parameters와 field assembly가 필요한 정규화된 JSON을 반환하며, rate limits는 endpoint별, auth-type별, 15분 창별로 적용되어 초과 시 429 status code를 반환합니다. ApiPass는 모든 legacy field, professional badge, affiliate label이 기본 포함된 원시 Twitter GraphQL 응답을 간단한 async task 모델 뒤에서 제공하며, 관리해야 할 15분 창이 없습니다.
경쟁사의 팔로워 목록을 주기적으로 내보내어 그들의 오디언스가 내 오디언스와 어디에서 겹치는지 추적하고 아직 공략하지 않은 세그먼트를 발견하세요.
새 팔로워의 account age (created_at), statuses_count, default_profile_image 플래그를 분석해 보유 계정에서 비정상적인 참여를 표시하세요.
출시 마일스톤마다 팔로워 목록의 스냅샷을 생성해 토큰을 에어드롭하거나, Discord 접근을 제한하거나, 크리에이터 계정의 초기 지지자에게 보상하세요.
특정 분야의 기자, 애널리스트, 오피니언 리더 팔로워를 가져와 영향력 네트워크를 매핑하고 아웃리치 목록을 개선하세요.
ApiPass에 가입하고 대시보드에서 bearer token을 생성한 뒤, 이를 Authorization: Bearer YOUR_API_KEY 헤더에 복사하세요.
https://api.apipass.dev/api/v1/jobs/createTask로 POST 요청을 보내고 model: "twitter/graphql/followers"와 대상 userId(필수), 선택 사항인 count 및 includePromotedContent 필드를 포함한 input.variables 객체를 전달하세요. webhook 알림을 원한다면 callBackUrl을 포함하세요. 응답으로 taskId를 받게 됩니다.
callback이 callBackUrl에서 실행될 때까지 기다리거나, GET https://api.apipass.dev/api/v1/jobs/recordInfo?taskId=task_xxxx를 사용해 state가 success가 될 때까지 폴링하세요. 모든 사용자의 프로필 메타데이터, 인증 상태, 참여 수치를 포함한 전체 팔로워 페이로드는 data.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입니다
