Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
followers-you-know otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
단일 GraphQL 기반 API 호출로 상호 연결 목록, 즉 나와 다른 Twitter/X 사용자가 모두 알고 있는 팔로워를 조회하세요.
ApiPass의 Twitter Graphql Followers You Know API는 Twitter/X의 내부 GraphQL 계층을 활용해, 나(인증된 사용자)와 대상 사용자가 공통으로 팔로우하는 계정 목록을 가져오는 비동기 엔드포인트입니다. AuthToken과 함께 대상 userId를 제출하면 ApiPass가 백그라운드 작업을 생성하고, 각 상호 연결에 대해 screen name, display name, follower counts, verification status, professional category, profile media를 포함한 상세 사용자 프로필이 담긴 풍부한 타임라인 페이로드를 반환합니다. ApiPass의 통합 작업 기반 아키텍처(createTask → recordInfo)를 기반으로 구축되어 Twitter의 비공개 GraphQL 스키마 복잡성을 추상화하며, 개발자는 깔끔하고 구조화된 JSON 결과를 소비하는 데만 집중할 수 있습니다.
Twitter의 비공개 GraphQL query IDs, feature flags, variable schemas를 해석하는 번거로움을 건너뛰세요. ApiPass가 저수준 프로토콜을 처리하므로 간단한 JSON body만 전달하면 됩니다.
ApiPass는 실시간 가격 및 안정성 지표를 기반으로 starter, regular, official 제공자에 요청을 자동 분산하여, 수동 구성 없이도 비용과 신뢰성의 최적 균형을 제공합니다.
요청을 보내면 즉시 taskId를 받고, webhook(callBackUrl) 또는 recordInfo 폴링을 통해 결과를 받을 수 있습니다. 긴 HTTP 연결을 열린 상태로 유지하지 않고도 배치 소셜 그래프 분석에 적합합니다.
각 상호 팔로워 항목에는 rest_id, screen_name, follower/friends counts, is_blue_verified, professional category, profile images, banner URLs, pinned tweets 등 필요한 모든 정보가 하나의 페이로드에 포함됩니다.
starter 및 regular 채널은 Twitter의 공식 엔터프라이즈 API 티어보다 훨씬 낮은 가격으로 제공되며, official 채널은 필요할 때 네이티브 수준에 가까운 안정성을 제공합니다.
플랫폼 액세스에는 ApiPass Bearer API key를, 사용자 범위 데이터에는 표준 Twitter auth_token cookie를 사용하여 하나의 청구 계정에서 여러 Twitter ID를 확장 운영할 수 있습니다.
count parameter(예: 20)를 사용해 작업당 반환되는 상호 팔로워 수를 제어하여, 페이지네이션 또는 미리보기 시나리오에 맞게 페이로드 크기를 조정할 수 있습니다.
includePromotedContent boolean을 사용하면 타임라인에서 스폰서 항목을 깔끔하게 제외해 데이터셋이 유기적인 상호 연결에 집중되도록 유지할 수 있습니다.
결과는 TimelineUser 항목이 포함된 전체 TimelineAddEntries 구조 안에 반환되며, 후속 조정을 위해 Twitter의 네이티브 정렬(sortIndex)과 entry IDs를 보존합니다.
기존 팔로워 중 누가 잠재 고객을 이미 팔로우하고 있는지 보여주는 영업 또는 네트워킹 앱을 구축해, 콜드 아웃리치 대신 따뜻한 소개를 가능하게 하세요.
내 오디언스와 경쟁사, 인플루언서 또는 파트너 계정 간의 중복을 시각화하여 공유 커뮤니티와 교차 프로모션 기회를 파악하세요.
상호 팔로워 데이터를 is_blue_verified, followers_count, professional category 신호와 결합해 캠페인 비용을 집행하기 전에 신뢰도를 평가하세요.
공유 연결을 보여주는 미니 피드를 사용자 프로필 페이지에 삽입하여, 자체 제품 안에서 네이티브 "Followers you know" UX를 구현하세요.
Twitter의 공식 API는 팔로워 그래프 엔드포인트를 엄격한 속도 제한과 긴 신청 검토가 필요한 고가의 Enterprise 티어로 제한합니다. ApiPass는 간단한 POST /api/v1/jobs/createTask 호출을 통해 동일한 GraphQL 엔드포인트를 제공하며, 세 가지 제공자 채널에서 종량제 가격을 지원합니다. 엔터프라이즈 계약은 필요하지 않습니다.
공식 API는 query hashes, feature flags, PKCE가 포함된 OAuth 2.0을 직접 관리해야 하는 원시 GraphQL 응답을 반환합니다. ApiPass는 모든 것을 단일 JSON body(model, input.AuthToken, input.variables)로 래핑하고, callback 또는 가벼운 GET /recordInfo?taskId=... 폴링으로 결과를 반환하여 통합 시간을 크게 단축합니다.
X에서 리드에게 연락하기 전에 영업팀은 상호 팔로워를 조회하여 소개를 도와줄 수 있는 따뜻한 연결을 파악하고 응답률을 높입니다.
신뢰 담당 팀은 의심되는 조직적 계정 간의 상호 팔로워 그래프를 매핑하여 봇넷, 가짜 계정 또는 비진정성 행동 클러스터를 탐지합니다.
에이전시는 브랜드의 기존 팔로워와 의미 있게 오디언스가 겹치는 크리에이터를 브랜드와 매칭하여 더 높은 ROI의 협업을 보장합니다.
X에서 정보 확산 또는 동질성을 연구하는 연구자들은 네트워크 분석을 위한 라벨링된 그래프 데이터셋을 구축하기 위해 상호 팔로워 엣지를 대규모로 수집합니다.
ApiPass에 가입하여 Bearer API key를 받은 다음, 브라우저에서 Twitter/X에 로그인하고 F12 → Application → Cookies에서 auth_token 값을 복사하세요. 이것이 input.AuthToken입니다.
model: "twitter/graphql/followers-you-know", 대상 userId, count, 그리고 선택적으로 callBackUrl을 포함해 https://api.apipass.dev/api/v1/jobs/createTask 로 POST 요청을 보내세요. 즉시 taskId를 받게 됩니다.
webhook이 callback URL에 도달할 때까지 기다리거나, state가 success로 전환될 때까지 GET /api/v1/jobs/recordInfo?taskId=... 를 호출하세요. resultJson.resultObject.data.user.result.timeline을 파싱하여 모든 상호 팔로워 항목을 순회할 수 있습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
알 수도 있는 팔로워를 가져옵니다.
이 API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "AuthToken": "string",
7 "variables": {
8 "userId": "string",
9 "count": "number",
10 "includePromotedContent": "boolean",
11 }
12 }
13}model필수string생성에 사용할 모델 이름입니다.
"twitter/graphql/followers-you-know"
callBackUrl선택적string작업 완료 알림을 위한 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내의 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체가 실제 이미지 및 동영상 생성 작업을 처리합니다. 현재 APIPASS는 세 가지 제공업체 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체에 작업을 자동으로 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구 사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 파라미터가 포함됩니다:
input.variables.userId필수string44196397
input.variables.count선택적number20
input.variables.includePromotedContent선택적booleanfalse
input.AuthToken필수stringTwitter 홈페이지를 열고 로그인한 다음 F12 > Application > Storage > Cookies > auth_token으로 이동합니다.
YOUR_X_AUTH_TOKEN
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/followers-you-know",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "AuthToken": "YOUR_X_AUTH_TOKEN",
9 "variables": {
10 "userId": "44196397",
11 "count": 20,
12 "includePromotedContent": false,
13 }
14 }
15 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공, 그 외는 실패를 의미합니다.
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다.
data.taskId작업 상태와 결과를 조회하기 위한 작업 ID입니다.
