Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
user-by-rest-id otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
ApiPass의 통합 GraphQL 엔드포인트를 통해 숫자형 사용자 ID로 전체 Twitter 사용자 프로필 데이터를 즉시 조회하세요.
ApiPass의 Twitter Graphql User By Rest ID API는 개발자가 숫자형 userId(rest_id라고도 함)를 제출해 포괄적인 Twitter 사용자 정보를 가져올 수 있는 강력한 엔드포인트입니다. 화면 이름 기반 조회와 달리, 이 엔드포인트는 사용자가 핸들을 변경하더라도 변하지 않는 안정적인 숫자 식별자를 사용해 Twitter의 GraphQL 백엔드를 직접 조회합니다. model twitter/graphql/user-by-rest-id와 함께 /api/v1/jobs/createTask로 간단한 POST 요청을 보내면 task ID를 받고, 이후 /api/v1/jobs/recordInfo 엔드포인트를 통해 표시 이름, screen name, avatar, banner, follower/following 수, verification status, professional account info, highlighted labels 등 전체 프로필 세부 정보를 조회할 수 있습니다. ApiPass가 인증, 라우팅, 제공자 선택을 자동으로 처리하므로 Twitter의 복잡한 내부 API를 다루는 대신 제품 개발에 집중할 수 있습니다.
변경될 수 있는 screen name 대신 영구적인 rest_id(예: Elon Musk의 44196397)로 사용자를 조회하여, 사용자가 핸들을 리브랜딩해도 통합 기능이 중단되지 않도록 보장합니다.
단일 Bearer YOUR_API_KEY 헤더가 Twitter의 복잡한 OAuth 2.0 흐름을 대체하여, 신규 프로젝트의 온보딩 부담을 크게 줄입니다.
기본 auto 채널은 실시간 가격 및 안정성 지표를 기반으로 starter, regular, official 제공자 간에 요청을 지능적으로 배분하여, 수동 설정 없이 비용과 신뢰성을 균형 있게 유지합니다.
선택적 callBackUrl을 지원하는 create-task 및 query-task 패턴을 통해, 높은 부하에서도 타임아웃되지 않는 확장 가능하고 논블로킹 방식의 파이프라인을 구축할 수 있습니다.
단일 호출로 is_blue_verified, professional data, highlights_info, affiliates_highlighted_label, relationship_perspectives 등을 포함한 40개 이상의 사용자 필드를 가져올 수 있으며, 추가 엔드포인트가 필요하지 않습니다.
official 채널은 Twitter 자체 요금에 맞춘 종량제 가격을 제공하며, 대량 처리나 덜 중요한 워크로드에는 더 저렴한 티어를 사용할 수 있습니다.
core(name, screen_name, created_at), avatar, legacy(followers, friends, statuses, listed counts), verification, professional, dm_permissions, highlights_info, tipjar_settings를 포함한 전체 GraphQL user.result 구조를 반환합니다.
withHighlightedLabel boolean을 전환해 affiliates_highlighted_label 블록을 포함하거나 제외할 수 있으며, 브랜드 제휴 및 인증된 비즈니스 배지를 표시하는 데 유용합니다.
모든 작업은 명확한 수명 주기 상태(waiting, queuing, generating, success, fail)를 거치며, 각 응답에는 createTime, completeTime, costTime 지표가 포함됩니다.
안정적인 rest_id로 추적되는 수천 명의 크리에이터에 대해 팔로워 증가, 참여 신호, 인증 상태를 지속적으로 모니터링하세요.
인증된 Twitter 프로필 데이터(표시 이름, bio 링크, professional category, business labels)를 고객 레코드에 추가하여 B2B 아웃리치 워크플로를 강화하세요.
account age(created_at), follower-to-following 비율, blue verification status를 검증하여 봇, 사기 또는 사칭 시도를 탐지하세요.
경쟁 계정의 지표를 시간에 따라 스냅샷으로 저장하고, 성장 추이와 콘텐츠 성과 신호를 비교하는 경쟁사 추적 제품을 구축하세요.
Twitter의 공식 API는 사용자 조회 엔드포인트에 직접 접근할 수 있게 해주지만, 대규모로 통합하려면 OAuth의 복잡성, 티어 기반 가격, 제한적인 필드 노출 등 상당한 부담이 따릅니다. ApiPass는 동일한 기본 GraphQL 인프라를 개발자 친화적인 인터페이스로 감싸 더 스마트한 라우팅, 더 풍부한 페이로드, 유연한 비용 티어를 제공합니다.
Twitter의 공식 API v2 GET /2/users/:id 엔드포인트는 OAuth 2.0 Bearer tokens, 앱 등록, 프로젝트 설정, 티어별 액세스 승인이 필요합니다. ApiPass는 이 모든 과정을 단일 API key로 대체합니다. 가입하고 key를 생성하면 몇 분 안에 호출을 시작할 수 있습니다. 개발자 포털 심사도, 앱 수준 rate-limit 협상도 필요하지 않습니다.
Twitter의 공식 엔드포인트는 액세스 티어별로 제한된 필드 집합만 제공하며, 더 높은 트래픽 티어는 비싼 월 구독 뒤에 제한되어 있습니다. ApiPass는 highlights_info, affiliates_highlighted_label, professional, relationship_perspectives를 포함한 더 풍부한 GraphQL 응답을 제공하고, starter, regular, official 채널 중에서 선택할 수 있게 해줍니다. 안정성이 미션 크리티컬할 때만 official 요금을 지불하고, 대량 조회는 더 낮은 티어를 통해 최대 90%까지 비용을 절감할 수 있습니다.
에어드롭 자격 또는 NFT whitelist 접근 권한을 부여하기 전에 rest_id로 지갑 연결 Twitter 계정을 확인하여, 위조된 screen-name 교체를 방지하세요.
기자와 OSINT 분석가는 보관된 숫자 ID를 현재 계정 상태로 해석하여, 공인의 프로필, bio, 인증 상태가 시간에 따라 어떻게 변화하는지 추적할 수 있습니다.
광고 클릭 또는 추천 링크에서 수집한 사용자 ID를 전체 프로필 스냅샷으로 변환하고, 팔로워 티어 또는 professional category별 특정 오디언스 세그먼트에 캠페인 성과를 연결하세요.
사용자가 Twitter ID로 지원팀에 문의하면 즉시 프로필을 가져와 신원을 확인하고, is_blue_verified 상태를 확인하며, 고가치 계정에 맞춘 응답을 제공하세요.
ApiPass에 가입하고 대시보드로 이동한 뒤 Bearer API key를 생성하세요. 앱 심사 과정, OAuth 설정, 대기 기간이 없으며, 등록 후 몇 분 안에 호출을 시작할 수 있습니다.
model을 twitter/graphql/user-by-rest-id로 설정하고 대상 숫자형 user ID를 input.variables 객체 안에 넣어 createTask 엔드포인트로 POST 요청을 보내세요. 필요에 따라 withHighlightedLabel 플래그를 전환해 affiliate badge 데이터를 포함할 수 있으며, 작업 완료 후 ApiPass가 결과를 서버로 자동 푸시하도록 callBackUrl을 제공할 수도 있습니다. 응답은 결과 조회에 사용할 고유 taskId를 반환합니다.
taskId를 query parameter로 포함하여 recordInfo 엔드포인트로 GET 요청을 보내세요. state 필드가 success를 반환할 때까지 엔드포인트를 폴링하거나 callback을 기다리면 됩니다. 그 시점에 core identity, avatar, follower metrics, verification status, professional account details, highlighted labels를 포함한 전체 Twitter 사용자 프로필이 중첩된 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입니다
