Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
audio-space-search otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
단일 API 호출로 라이브, 예정 및 지난 오디오 대화 전반에서 Twitter (X) Spaces를 검색하고 발견하세요.
ApiPass의 Twitter Graphql Audio Space Search API는 개발자가 유연한 키워드 쿼리와 상태 필터를 사용해 Twitter의 라이브 오디오 대화 기능인 Twitter Spaces를 프로그래밍 방식으로 검색할 수 있게 해주는 관리형 엔드포인트입니다. Twitter의 내부 GraphQL 계층을 기반으로 구축된 이 API를 사용하면 웹 인터페이스를 스크래핑하거나 Twitter 인증의 복잡성을 관리할 필요 없이 특정 주제, 키워드 또는 상태(예: Upcoming, Live, Past)와 일치하는 Spaces를 가져올 수 있습니다. ApiPass는 전체 워크플로를 간단한 2단계 작업 기반 시스템으로 래핑합니다. POST /api/v1/jobs/createTask를 통해 검색 요청을 제출한 다음, GET /api/v1/jobs/recordInfo를 통해 구조화된 JSON 결과를 가져오면 됩니다. 이 API는 Twitter의 오디오 생태계를 중심으로 오디오 콘텐츠 검색 도구, 소셜 리스닝 대시보드, 실시간 모니터링 파이프라인을 구축하는 데 이상적입니다.
모든 ApiPass 엔드포인트에서 일관된 create-task / query-task 패턴을 제공하여 통합을 예측 가능하게 만들고 코드베이스 전반에서 쉽게 표준화할 수 있습니다.
기본 auto 채널은 실시간 가격 및 안정성 지표를 기반으로 starter, regular, official 제공자 간에 요청을 자동으로 할당하여, 수동 튜닝 없이 비용과 안정성의 균형을 맞춥니다.
OAuth 흐름, 개발자 계정 승인, rate-limit 조율을 건너뛰고 ApiPass Bearer 토큰만 사용하면 됩니다.
키워드(query)로 검색하고 Upcoming과 같은 Space 상태(filter)로 범위를 좁혀 사용 사례와 관련된 예정 세션에 집중할 수 있습니다.
선택적 callBackUrl을 제공하면 작업 완료 시 자동 알림을 받을 수 있어, 프로덕션 시스템에서 polling 루프가 필요하지 않습니다.
초저비용 대량 실험에는 starter 티어를, 네이티브 API 가격으로 최대 안정성이 필요할 때는 official 티어를 선택하세요. 모두 동일한 인터페이스를 통해 이용할 수 있습니다.
자유 텍스트 query와 filter 매개변수(예: Upcoming)를 결합하여 관심 있는 Spaces만 정확하게 가져오세요.
장시간 실행되는 검색은 taskId를 사용해 비동기적으로 처리되며, 작업 상태(waiting, queuing, generating, success, fail)를 통해 처리 상태를 완전히 파악할 수 있습니다.
결과는 깔끔한 resultJson.resultObject 페이로드 안에 전달되며, 즉시 파싱하거나 저장하거나 다운스트림 분석으로 직접 연결할 수 있습니다.
crypto, AI, sports와 같은 특정 주제와 관련된 예정 Spaces를 선별해 보여주는 피드입니다.
트윗뿐만 아니라 라이브 오디오에서 발생하는 브랜드 언급과 업계 대화를 모니터링합니다.
호스트가 트렌드 주제와 자신의 Spaces를 예약하기에 최적인 시간을 파악하도록 돕습니다.
경쟁사나 업계 리더가 오디오 이벤트를 시작하는 시점을 추적하고 참여 패턴을 분석합니다.
Twitter의 공식 Spaces 검색 엔드포인트와 비교하여 ApiPass가 접근, 가격, 확장성을 어떻게 단순화하는지 확인하고 프로젝트에 맞는 최적의 선택을 하세요.
Twitter의 공식 API는 승인된 개발자 계정, 상위 접근 티어, 엄격한 rate limits가 필요하며, 유료 플랜은 소규모 팀에게 지나치게 비쌀 수 있습니다. ApiPass는 애플리케이션 절차 없이 간단한 Bearer 토큰 요청으로 동일한 기능을 제공하므로 몇 분 만에 구축을 시작할 수 있습니다.
Twitter의 공식 API는 접근 티어별로 단일 고정 가격 구조를 제공합니다. ApiPass는 starter, regular, official 제공자 중에서 동적으로 선택하거나 기본값인 auto를 사용할 수 있게 해주므로, 워크로드에 따라 비용과 안정성을 독립적으로 확장할 수 있습니다.
키워드 기반 Space 검색을 집계하여 대화 주제가 메인스트림 피드에 등장하기 전에 새롭게 떠오르는 흐름을 감지합니다.
컨퍼런스 해시태그, 제품 출시 또는 위기 상황과 관련된 모든 Spaces를 실시간으로 추적합니다.
기자와 연구자는 진행 중인 기사나 연구 주제와 관련된 라이브 오디오 토론을 발견할 수 있습니다.
기존 트윗 기반 언급과 함께 Twitter의 오디오 생태계에서 브랜드 또는 캠페인 키워드가 얼마나 자주 등장하는지 측정합니다.
ApiPass에 가입하고 대시보드에서 API 키를 생성하세요. 모든 요청의 Authorization 헤더에서 이를 Bearer 토큰으로 사용하게 됩니다.
model을 twitter/graphql/audio-space-search로 설정하여 /api/v1/jobs/createTask로 POST 요청을 보내세요. query 키워드와 결과 범위를 좁히기 위한 Upcoming과 같은 선택적 filter를 포함해 검색 매개변수를 input.variables 안에 제공하세요. 작업이 완료될 때 자동 알림을 받기 위해 선택적 callBackUrl을 포함할 수도 있습니다. 응답은 결과를 가져오는 데 사용할 고유한 taskId를 반환합니다.
taskId를 쿼리 매개변수로 사용하여 /api/v1/jobs/recordInfo로 GET 요청을 보내세요. state 필드를 모니터링하세요. success가 반환되면 Space 검색 결과가 data.resultJson.resultObject 안에서 제공되며, 이를 파싱해 애플리케이션에 통합할 수 있습니다. 2단계에서 callBackUrl을 제공했다면 ApiPass가 결과를 엔드포인트로 자동 푸시하므로 polling이 필요하지 않습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
Twitter Spaces 검색
이 API는 다음 구조의 JSON 페이로드를 허용합니다:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "filter": "string",
8 "query": "string"
9 }
10 }
11}model필수string생성에 사용할 모델 이름입니다.
"twitter/graphql/audio-space-search"
callBackUrl선택적string작업 완료 알림을 받을 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 매개변수를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체는 실제 이미지 및 동영상 생성 작업을 처리합니다. 현재 APIPASS는 세 가지 제공업체 옵션을 제공합니다:
channel 매개변수의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체 간에 작업을 자동으로 할당하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구사항이 없는 한 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 매개변수가 포함됩니다:
input.variables.filter선택적stringUpcoming
input.variables.query선택적stringa
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 "filter": "Upcoming",
10 "query": "a"
11 }
12 }
13 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공, 그 외 값은 실패를 의미합니다.
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다.
data.taskId작업 상태와 결과를 조회하기 위한 작업 ID입니다.
