Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
user-by-screen-name otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
단일 screen_name만 전달하면 완전한 X (Twitter) 사용자 프로필 데이터를 즉시 가져올 수 있습니다. OAuth도, rate-limit 문제도, 수동 GraphQL 서명도 필요 없습니다.
ApiPass의 Twitter Graphql User By Screen Name API는 X의 내부 UserByScreenName GraphQL 작업을 깔끔한 비동기 REST 인터페이스 뒤에 래핑한 관리형 엔드포인트입니다. 게스트 토큰, 쿼리 ID, 기능 플래그, 계속 변경되는 GraphQL 해시를 처리하는 대신, screen_name(예: elonmusk)을 model twitter/graphql/user-by-screen-name과 함께 /api/v1/jobs/createTask로 POST하기만 하면 됩니다. 그러면 ApiPass가 taskId를 반환하며, 이를 /api/v1/jobs/recordInfo로 폴링하거나 callBackUrl을 통해 자동으로 받을 수 있습니다. 응답에는 rest_id, 표시 이름, 자기소개, 팔로워/팔로잉 수, 인증 상태, 프로필 및 배너 이미지, 생성일, 위치, 고정 트윗, 강조 라벨, 안전 모드 필드 등 전체 사용자 객체가 포함됩니다. 내부적으로 ApiPass의 channel: auto 라우터는 비용, 안정성, 속도의 균형을 맞추기 위해 각 호출을 starter, regular, official 제공업체에 실시간으로 분산합니다. 따라서 /graphql/.../UserByScreenName 경로를 직접 다루지 않고도 프로덕션 수준의 Twitter 사용자 데이터를 얻을 수 있습니다.
X 개발자 포털 절차를 모두 건너뛰세요. Authorization: Bearer YOUR_API_KEY 헤더 하나면 충분합니다. 앱 심사, consumer keys, access tokens가 필요 없습니다.
X의 사용량 기반 과금 모델에서 사용자 프로필 조회는 건당 약 $0.010이며, 무료 티어는 더 이상 신규 개발자에게 제공되지 않고 기존 사용자도 사용량 기반 과금으로 전환되었습니다. ApiPass의 다중 제공업체 라우팅은 가장 저렴하면서도 안정적인 채널에 자동으로 연결해 줍니다.
기본값인 channel: auto를 사용하면 APIPASS가 실시간 가격 및 안정성 지표를 기준으로 각 작업을 starter, regular, official 제공업체에 배분합니다. 수동 튜닝 없이도 최적의 가격 대비 신뢰성을 얻을 수 있습니다.
기본적으로 id/name/username만 반환하며 fields와 expansions를 직접 열거해야 하는 X API v2와 달리(X API v2 버전은 기본적으로 user id, name, username 필드만 제공하고 추가 필드를 요청하려면 fields 및 expansions 파라미터를 사용해야 함), GraphQL 엔드포인트는 풍부한 전체 사용자 객체를 단일 호출로 반환합니다.
fire-and-forget 작업은 즉시 taskId를 반환합니다. callBackUrl을 제공하면 결과가 준비되는 즉시 ApiPass가 서버로 푸시하므로 서버리스 및 큐 기반 아키텍처에 적합합니다.
자체 코드에서 15분 rolling window를 관리할 필요도, guest-token 갱신 로직도, GraphQL query-hash 변경 대응도 필요 없습니다. ApiPass가 이러한 업스트림 복잡성을 모두 흡수해 애플리케이션을 단순하게 유지합니다.
screen_name: "elonmusk"를 전달하면 완전한 사용자 객체를 받을 수 있습니다. 여기에는 거의 모든 다른 Twitter GraphQL 엔드포인트(UserTweets, Followers, Following, UserMedia 등)에 필요한 표준 숫자 사용자 ID인 rest_id가 포함됩니다.
input.variables 객체에서 withSafetyModeUserFields와 withHighlightedLabel을 직접 토글하여 응답에 표시될 확장 프로필 필드(안전 모드 메타데이터, 강조된 크리에이터 라벨)를 제어할 수 있습니다.
모든 요청은 일관된 waiting → queuing → generating → success / fail 상태 머신을 거치며 /api/v1/jobs/recordInfo로 조회할 수 있습니다. createTime, completeTime, costTime, resultJson이 예측 가능한 스키마로 반환됩니다.
모든 @handle을 다운스트림 파이프라인에 필요한 안정적인 숫자 rest_id로 변환하세요.
팔로워 수, 인증 배지, 자기소개 키워드, 계정 나이, 강조 라벨을 가져와 대규모로 프로필을 점수화하고 순위를 매기세요.
가입, 경품 이벤트 또는 KOL 파트너십을 승인하기 전에 제출된 Twitter 핸들이 존재하고, 활성 상태이며, 보호 계정이 아니고, 예상 메타데이터와 일치하는지 자동으로 검증하세요.
Twitter 핸들이 포함된 모든 연락처 레코드에 프로필 사진, 위치, 웹사이트 URL, 팔로워 수, 생성일을 밀리초 단위로 보강하세요.
X의 공식 API는 사용자 조회에 개발자 승인, 티어형 가격, 제한적인 기본 필드를 요구하지만, ApiPass는 단순한 자동 라우팅 작업당 과금 호출 하나로 전체 GraphQL 프로필 객체를 제공합니다.
공식 GET /2/users/by/username/:username 엔드포인트는 query params를 통해 필드를 수동으로 확장해야 하며, 기본적으로 id, name, username만 제공합니다. 추가 필드에는 fields 및 expansions 파라미터가 필요합니다. ApiPass의 GraphQL 래퍼는 fields= 열거 없이 고정 트윗, professional-account 정보, 인증 유형, 강조 라벨을 포함한 전체 네이티브 사용자 객체를 한 번의 호출로 반환합니다.
X는 게시물 작성 비용이 약 0.010, 게시물 읽기 비용이 약 0.005, 사용자 프로필 조회 및 DM 읽기 비용이 각각 약 $0.010인 사용량 기반 모델로 접근 방식을 통합했으며, 여기에 월간 한도가 더해집니다. ApiPass는 성공한 작업에 대해서만 과금하고, 기본적으로 가장 저렴하고 안정적인 제공업체로 라우팅하며, 개발자 포털 신청 단계가 필요 없습니다.
트윗 스트림에서 언급된 모든 핸들을 전체 프로필로 변환하여 분석가가 팔로워 규모, 인증 상태 또는 계정 나이로 필터링할 수 있게 하세요.
토큰, NFTs 또는 whitelist spots를 발급하기 전에 지갑에 연결된 Twitter 핸들이 실제이며, 충분히 오래되었고, 팔로워 기준을 충족하는지 확인하세요.
조사 대상인 모든 공개 계정에 대해 신뢰할 수 있는 메타데이터(생성일, 위치, 프로필 이력 신호, 강조 라벨)를 빠르게 가져오세요.
후보자의 Twitter 핸들에 자기소개, 웹사이트 URL, 팔로워 수를 보강하여 개발자 애드보케이트, 디자이너, 크리에이터를 찾아 아웃리치하세요.
ApiPass에 가입하고 대시보드에서 YOUR_API_KEY를 가져오세요. 개발자 포털 신청, OAuth 설정, 앱 심사가 필요 없습니다. 단일 bearer token으로 플랫폼의 모든 모델을 사용할 수 있습니다.
model을 twitter/graphql/user-by-screen-name으로 설정하고 대상 핸들을 input.variables.screen_name 안에 제공하여(예: elonmusk) https://api.apipass.dev/api/v1/jobs/createTask로 POST 요청을 보내세요. 선택적으로 withSafetyModeUserFields와 withHighlightedLabel을 포함해 응답을 보강하고, ApiPass가 결과를 서버로 자동 푸시하도록 하려면 callBackUrl을 전달하세요. API는 task_12345678과 같은 taskId로 즉시 응답합니다.
ApiPass가 완료된 페이로드를 callBackUrl로 POST할 때까지 기다리거나, bearer token과 함께 https://api.apipass.dev/api/v1/jobs/recordInfo?taskId=task_12345678을 폴링하세요. data.state가 success가 되면 rest_id, 자기소개, 팔로워 및 팔로잉 수, 인증 상태, 프로필 이미지, 생성일, 요청한 선택 필드를 포함한 전체 사용자 프로필이 data.resultJson.resultObject 안에서 제공됩니다. 이제 프로덕션에서 Twitter GraphQL 사용자 데이터를 가져올 수 있습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
screen_name으로 사용자 정보를 가져옵니다
API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "screen_name": "string",
8 "withSafetyModeUserFields": "boolean",
9 "withHighlightedLabel": "boolean",
10 }
11 }
12}model필수string생성에 사용할 모델 이름입니다.
"twitter/graphql/user-by-screen-name"
callBackUrl선택적string작업 완료 알림을 받을 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 매개변수를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체는 실제 이미지 및 동영상 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다:
channel 매개변수의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체에 작업을 자동으로 할당하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 매개변수가 포함됩니다:
input.variables.screen_name필수stringelonmusk
input.variables.withSafetyModeUserFields선택적booleantrue
input.variables.withHighlightedLabel선택적booleantrue
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 "screen_name": "elonmusk",
10 "withSafetyModeUserFields": true,
11 "withHighlightedLabel": true
12 }
13 }
14 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공을 의미하며, 그 외 값은 실패를 의미합니다.
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다.
data.taskId작업 상태와 결과를 조회하기 위한 작업 ID입니다.
