Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
audio-space-by-id otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
고유한 Space ID를 사용하여 모든 Twitter/X Audio Space의 전체 메타데이터, 호스트 세부 정보, 참가자 정보를 조회합니다.
ApiPass의 Twitter Graphql Audio Space By Id API는 Space ID(예: 1YpJkglaMaYJj)를 제공하여 특정 Twitter/X Space에 대한 종합 데이터를 가져올 수 있는 강력한 엔드포인트입니다. Space의 제목, 상태(live, scheduled, ended, canceled), 생성 및 예약 타임스탬프, 생성자 프로필, 관리자, 발표자, 청취자, 리플레이 사용 가능 여부, 총 라이브 청취자 수 및 리플레이 조회수와 같은 참여 지표를 포함한 풍부한 구조화 정보를 반환합니다. Twitter의 GraphQL 인프라를 기반으로 구축된 ApiPass는 이 기능을 간단한 비동기 작업 기반 워크플로로 래핑합니다. /api/v1/jobs/createTask를 통해 요청을 제출한 다음 /api/v1/jobs/recordInfo를 통해 결과를 조회하면 되므로 OAuth 인증, 속도 제한 또는 GraphQL 쿼리 구성을 직접 관리할 필요가 없습니다.
Twitter Enterprise API 티어의 긴 승인 절차를 건너뛰고 ApiPass API 키만으로 즉시 Spaces 데이터를 조회할 수 있습니다.
channel 파라미터의 기본값은 auto이며, 실시간 가격 및 안정성 지표를 기준으로 사용 가능한 제공업체에 작업을 자동으로 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다.
예산과 안정성 요구 사항에 맞춰 starter(초저비용), regular(공식 API 가격보다 훨씬 낮은 표준 티어), official(최대 안정성을 제공하는 네이티브 Twitter API) 중에서 선택할 수 있습니다.
선택적 콜백 URL을 지원하는 작업 기반 설계를 통해 애플리케이션을 차단하지 않고 대규모로 요청을 실행할 수 있어 수천 개의 Spaces를 일괄 처리하는 데 적합합니다.
withReplays, withListeners, isMetatagsQuery 플래그를 전환하여 필요한 데이터만 가져오고 페이로드 크기와 처리 오버헤드를 줄일 수 있습니다.
명확한 상태 값(waiting, queuing, generating, success, fail)을 포함한 깔끔하고 예측 가능한 JSON 출력을 제공하여 애플리케이션 로직을 단순하게 유지할 수 있습니다.
제목, 상태, 미디어 키, 예약 시작 시간, 생성/업데이트 타임스탬프, 대화 제어, 리플레이/클리핑 사용 가능 여부 등을 반환합니다.
사용자 ID, 표시 이름, 인증 상태, 아바타, Periscope 사용자 ID가 포함된 상세한 관리자, 발표자, 청취자 배열에 액세스할 수 있습니다.
스크린 네임, 팔로워 수, 프로필 이미지, 자기소개, 위치, 인증 배지, 계정 생성일 등 깊이 중첩된 생성자 데이터를 포함합니다.
여러 Spaces에서 total_live_listeners 및 total_replay_watched와 같은 참여 지표를 추적하여 인기 오디오 콘텐츠를 식별합니다.
특정 생성자가 호스팅한 예정 및 과거 Spaces를 전체 프로필 데이터와 함께 보여주는 플랫폼을 구축합니다.
미디어 인텔리전스, 연구 또는 컴플라이언스 목적으로 과거 Spaces(제목, 호스트, 예약 시간, 리플레이 사용 가능 여부)를 카탈로그화합니다.
대상 Spaces가 시작되거나 종료되거나 리플레이로 제공될 때 사용자에게 알리는 알림 시스템을 만듭니다.
Twitter Spaces 데이터에 대한 ApiPass의 간소화되고 비용 효율적인 액세스를 Twitter 공식 API의 엔터프라이즈급 요구 사항과 비교하고, 동일한 데이터가 필요하지만 오버헤드는 피하고 싶은 개발자에게 ApiPass가 더 현명한 선택인 이유를 확인하세요.
Twitter의 공식 API는 Spaces 관련 GraphQL 엔드포인트에 액세스하기 위해 Enterprise 티어 구독(월 수천 달러)과 검증된 개발자 계정이 필요합니다. ApiPass는 공식 API보다 훨씬 낮은 regular 티어 가격과 초저비용 액세스를 제공하는 starter 티어를 포함한 종량제 모델로 동일한 데이터를 제공합니다.
공식 엔드포인트는 OAuth 2.0 인증, 수동 GraphQL 쿼리 구성, 기능 플래그 관리, 엄격한 속도 제한 처리를 요구합니다. ApiPass는 이 모든 것을 단일 Bearer 토큰을 사용하는 2단계 REST 워크플로(create task → query task)로 추상화하며, 동일한 Twitter 응답 구조를 반환하므로 운영 오버헤드 없이 전체 데이터 충실도를 유지할 수 있습니다.
경쟁사 또는 업계 리더가 호스팅하는 Spaces를 모니터링하여 콘텐츠 전략, 청중 규모, 참여 패턴을 파악합니다.
팩트체크, 탐사 보도 또는 오픈소스 인텔리전스 수집을 위해 Space 메타데이터(생성자, 타임스탬프, 참가자)를 검증합니다.
팟캐스터와 크리에이터가 시간에 따른 Spaces 성과, 리플레이 참여도, 청중 증가를 측정할 수 있도록 돕는 SaaS 제품을 지원합니다.
많은 crypto 프로젝트가 Spaces를 통해 AMA를 진행합니다. 이 API를 사용하여 모든 프로젝트 Space를 기록하고, 참가자 목록을 아카이빙하며, 조직적인 홍보 활동을 탐지할 수 있습니다.
ApiPass에 가입하고 대시보드에서 Bearer 토큰을 생성하여 모든 요청을 인증합니다.
모델을 twitter/graphql/audio-space-by-id로 설정하고 Space id와 선택적 플래그 isMetatagsQuery, withReplays, withListeners를 함께 제공하여 https://api.apipass.dev/api/v1/jobs/createTask로 POST 요청을 보냅니다. 응답으로 taskId를 받게 되며, 이를 사용하여 작업 진행 상황을 추적할 수 있습니다.
반환된 taskId를 사용하여 https://api.apipass.dev/api/v1/jobs/recordInfo로 GET 요청을 보내 결과를 가져옵니다. state가 success가 되면 전체 Audio Space 데이터를 resultJson 필드에서 사용할 수 있습니다. 선택적으로 Step 2에서 callBackUrl을 제공하면 작업이 완료될 때 자동 알림을 받을 수 있어 폴링이 필요 없습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
Space ID로 Space 정보를 가져옵니다
이 API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "id": "string",
8 "isMetatagsQuery": "boolean",
9 "withReplays": "boolean",
10 "withListeners": "boolean"
11 }
12 }
13}model선택적string생성에 사용할 모델 이름
"twitter/graphql/audio-space-by-id"
callBackUrl선택적string작업 완료 알림을 위한 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 매개변수를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체는 실제 이미지 및 동영상 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다:
channel 매개변수의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체에 작업을 자동으로 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 매개변수가 포함됩니다:
input.variables.id필수string1YpJkglaMaYJj
input.variables.isMetatagsQuery선택적booleanfalse
input.variables.withReplays선택적booleantrue
input.variables.withListeners선택적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 "id": "1YpJkglaMaYJj",
10 "isMetatagsQuery": false,
11 "withReplays": true,
12 "withListeners": true,
13 }
14 }
15 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공을, 그 외 값은 실패를 나타냅니다
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다
data.taskId작업 상태와 결과를 조회하기 위한 작업 ID
