Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
search-timeline otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
키워드, 해시태그 또는 고급 쿼리로 Twitter 타임라인을 프로그래밍 방식으로 검색하고 실시간 트윗 결과를 가져옵니다.
ApiPass의 Twitter Graphql Search Timeline API는 개발자가 Twitter의 기본 클라이언트에서 사용하는 동일한 GraphQL 스키마를 통해 Twitter(X)의 검색 타임라인을 쿼리할 수 있는 작업 기반 엔드포인트입니다. model을 twitter/graphql/search-timeline으로 설정해 /api/v1/jobs/createTask에 POST 요청을 보내면 원시 검색 쿼리(키워드, 해시태그, 연산자 또는 사용자 핸들)를 제출하고, 일치하는 트윗, 작성자 프로필, 미디어 엔터티, 참여 지표 및 페이지네이션 커서가 포함된 구조화된 JSON 페이로드를 받을 수 있습니다. 이 API는 Latest와 같은 여러 결과 모드를 지원하며 전체 GraphQL 응답을 반환하므로, OAuth, 속도 제한 또는 스크래핑 인프라를 직접 관리하는 복잡함 없이 Twitter 자체 검색 인터페이스를 구동하는 것과 동일한 수준의 깊이 있는 데이터를 제공합니다.
긴 신청, 승인 및 elevated-access 절차를 건너뛰세요. 단일 ApiPass API 키만으로 엔드포인트를 즉시 사용할 수 있습니다.
tweet_results, user_results, 미디어 variants, 조회수 및 하이라이트 범위를 포함해 Twitter의 기본 웹 클라이언트가 사용하는 것과 동일한 풍부한 데이터 구조를 얻을 수 있습니다.
기본 channel: auto 설정을 사용하면 ApiPass가 실시간 가격과 안정성을 기준으로 starter, regular, official 프로바이더 전반에 요청을 자동으로 분산하여 최적의 비용 대비 안정성 비율을 제공합니다.
검색 작업을 제출한 뒤 폴링하거나 callBackUrl을 통해 콜백을 받을 수 있어 대규모 크롤링, 배치 파이프라인 및 장시간 실행 워크로드에 적합합니다.
cursor 매개변수를 사용해 단일 페이지가 반환하는 범위를 넘어 수천 개의 일치 트윗을 순차적으로 탐색할 수 있습니다.
예산에 맞는 프로바이더 티어를 선택하세요: 초저가 starter, 비용 효율적인 regular, 또는 프리미엄 안정성과 함께 Twitter 자체 서비스와 동일한 가격의 official.
rawQuery 매개변수는 간단한 키워드("twitter")부터 복잡한 Twitter 검색 연산자, 해시태그, from: 필터, 날짜 범위 및 언어 플래그까지 모두 허용합니다.
product 매개변수를 통해 Latest와 같은 검색 제품으로 전환하여 시간순으로 최신 트윗을 가져오고, count(기본값 40)로 페이지 크기를 제어할 수 있습니다.
각 항목에는 전체 텍스트, 미디어(이미지, GIF, 비디오 variants), 사용자 프로필 세부 정보, 타임스탬프, 답글/리트윗/좋아요 수, 조회수 및 대화 스레딩 필드가 포함됩니다.
브랜드 언급, 경쟁사 활동 또는 속보 키워드를 모니터링하고 이를 분석 도구에 표시합니다.
원시 트윗 스트림을 NLP 모델에 입력하여 제품, 선거 또는 시장 이벤트를 둘러싼 감성 변화를 추적합니다.
캐시태그($BTC, $TSLA) 또는 인플루언서 핸들을 모니터링하고 관련 트윗이 발생하면 알림, 거래 또는 Discord/Telegram 알림을 트리거합니다.
블로그, 라이브 이벤트 페이지 및 기자 리서치 대시보드를 위해 해시태그 또는 주제별 트윗 임베드를 자동 큐레이션합니다.
ApiPass와 Twitter 공식 개발자 플랫폼이 검색 요청의 액세스 요구 사항과 반환 데이터의 깊이에서 어떻게 다른지 비교해 보세요.
Twitter의 공식 v2 Search API는 단일 요청을 보내기 전에 유료 개발자 구독(Basic, Pro 또는 Enterprise 티어), 프로젝트 승인 및 OAuth 2.0 설정이 필요합니다. ApiPass는 Bearer API 키만 있으면 됩니다. 기본 검색 액세스에 대한 제한 티어 없이 가입 후 몇 분 안에 작업을 생성할 수 있습니다.
Twitter의 공식 REST v2 엔드포인트는 요청한 tweet.fields / user.fields에 의해 제한되는 평면화된 필드 선택 JSON을 반환하며, 많은 내부 신호를 생략합니다. ApiPass는 Twitter 자체 웹 클라이언트를 반영하는 원시 GraphQL 응답(search_by_raw_query.search_timeline.timeline.instructions)을 반환하여 views.count, edit_control, highlights.textHighlights, clientEventInfo 및 전체 미디어 video_info.variants와 같은 더 풍부한 객체를 노출합니다. 이는 공식 API에서 숨겨져 있거나 프리미엄 티어가 필요한 데이터입니다.
회사, 제품 SKU 또는 임원에 대한 언급을 지속적으로 검색하고 부정적 감성을 고객 지원 워크플로로 라우팅합니다.
정량 연구를 위해 특정 주제, 해시태그 또는 지리적 위치와 관련된 대규모 과거 또는 실시간 트윗 데이터셋을 수집합니다.
틈새 키워드를 검색하고 결과 작성자를 followers_count, favourites_count 및 참여도 기준으로 순위화하여 특정 분야에서 떠오르는 목소리를 식별합니다.
경쟁사 캠페인 해시태그 또는 슬로건을 검색하여 플랫폼 전반에서 사용되는 도달 범위, 참여도 및 크리에이티브 접근 방식을 벤치마킹합니다.
ApiPass에 가입하고 대시보드에서 Bearer 토큰을 생성하세요. 이 단일 키로 모든 요청이 인증되므로 OAuth 흐름이나 Twitter 개발자 신청이 필요하지 않습니다.
model을 twitter/graphql/search-timeline으로 설정하여 /api/v1/jobs/createTask 엔드포인트에 POST 요청을 보내고, input.variables 안에 검색 매개변수를 포함하세요. 최소한 rawQuery가 필요하며, count, product, cursor와 같은 선택 필드를 추가할 수 있습니다. 선택적으로 작업 완료 시 푸시 알림을 받기 위해 callBackUrl을 제공할 수 있습니다.
2단계에서 반환된 taskId를 사용해 /api/v1/jobs/recordInfo 엔드포인트를 쿼리하세요. 작업 상태가 success가 되면 resultJson 필드를 파싱하여 일치하는 전체 트윗 목록을 확인하고, 반환된 페이지네이션 cursor를 사용해 필요에 따라 추가 페이지를 가져오세요.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
타임라인을 검색합니다.
이 API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "rawQuery": "string",
8 "count": "number",
9 "cursor": "string",
10 "querySource": "string",
11 "product": "string",
12 "includePromotedContent": "boolean",
13 }
14 }
15}model필수string생성에 사용할 모델 이름입니다.
"twitter/graphql/search-timeline"
callBackUrl선택적string작업 완료 알림을 받을 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 제공자를 지정할 수 있습니다. 이 제공자들은 실제 이미지 및 비디오 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공자 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공자에 작업을 자동으로 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 별도의 라우팅 요구사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 파라미터가 포함됩니다:
input.variables.rawQuery필수stringinput.variables.count선택적number40
input.variables.cursor선택적stringinput.variables.querySource선택적stringtyped_query
input.variables.product선택적stringLatest
input.variables.includePromotedContent선택적booleanfalse
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/search-timeline",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "rawQuery": "twitter",
10 "count": 40,
11 "cursor": "",
12 "querySource": "typed_query",
13 "product": "Latest",
14 "includePromotedContent": false,
15 }
16 }
17 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공을, 그 외 값은 실패를 의미합니다.
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다.
data.taskId작업 상태 및 결과를 조회하기 위한 작업 ID입니다.
