Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
create-tweet otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 사용 전체 가이드
단일 통합 엔드포인트를 통해 텍스트, 미디어 첨부, 답글, 민감한 콘텐츠 플래그를 완벽하게 지원하며 인증된 모든 X (Twitter) 계정에 프로그래밍 방식으로 트윗을 게시할 수 있습니다.
ApiPass의 Twitter Graphql Create Tweet API는 개발자가 Twitter의 공식 개발자 프로그램 승인 절차를 거치지 않고도 인증된 Twitter/X 계정을 대신해 트윗을 게시할 수 있게 해주는 POST 엔드포인트(/api/v1/jobs/createTask)입니다. 로그인된 Twitter 세션의 auth_token 쿠키를 트윗 페이로드와 함께 전달하면 일반 텍스트 트윗 게시, 최대 4개의 미디어 항목 첨부, 기존 트윗에 답글 달기, 미디어 내 사용자 태그, 시맨틱 주석 추가, 콘텐츠를 민감할 수 있음으로 표시할 수 있습니다. 이 API는 비동기 방식으로 작동하며, 각 요청은 taskId를 반환합니다. 트윗이 성공적으로 게시되면 recordInfo 엔드포인트를 통해 폴링하거나 callback으로 결과를 받을 수 있습니다.
긴 Twitter Developer Platform 신청 절차, elevated access 심사, 엔터프라이즈 티어 제한을 건너뛰세요. 표준 auth_token 쿠키로 인증하고 즉시 게시를 시작할 수 있습니다.
ApiPass는 여러 제공업체(starter, regular, official)를 통해 요청을 라우팅하며, Twitter 공식 Basic(200/month) 또는 Pro(5,000/month) 티어보다 훨씬 낮은 가격을 제공합니다. 기본 auto 채널은 실시간으로 가장 비용 효율적이고 안정적인 제공업체를 자동 선택합니다.
media_entities, tagged_users, semantic_annotation_ids, dark_request 및 기존 REST 엔드포인트에는 노출되지 않는 답글 스레드 제어를 포함해 Twitter 웹 클라이언트가 사용하는 동일한 내부 GraphQL mutation에 접근할 수 있습니다.
모든 트윗 생성 요청은 조회하거나 callBackUrl을 통해 받을 수 있는 taskId를 반환하므로, 애플리케이션 스레드를 차단하지 않고도 안정적인 대규모 게시 파이프라인을 쉽게 구축할 수 있습니다.
인증이 AuthToken을 통해 요청별로 이루어지므로, 하나의 API key로 무제한 Twitter 계정을 관리할 수 있습니다. 에이전시, 소셜 미디어 관리 도구, 다중 브랜드 게시에 이상적입니다.
하나의 JSON 페이로드로 텍스트 전용 트윗, 미디어 트윗, 답글, 민감한 콘텐츠 게시를 모두 처리할 수 있습니다. multipart 업로드, 별도 미디어 엔드포인트, 트윗 유형별 다른 인증 흐름을 따로 관리할 필요가 없습니다.
media_id 참조가 포함된 media.media_entities를 통해 사전 업로드된 미디어를 첨부하고, tagged_users로 이미지에 사용자를 태그하며, 필요할 때 업로드를 possibly_sensitive로 표시할 수 있습니다.
reply.in_reply_to_tweet_id를 사용해 기존 대화에 답글을 게시하고, reply.exclude_reply_user_ids를 통해 답글 알림 체인에서 특정 참여자를 선택적으로 제외할 수 있습니다.
auto, starter, regular, official 채널 중에서 선택해 워크로드에 따라 비용, 안정성, 속도의 균형을 맞출 수 있습니다. 초저비용 대량 게시부터 프로덕션급 official-tier 안정성까지 지원합니다.
사용자가 자신의 X 계정을 연결하고 수십 개 계정에 걸쳐 트윗, 스레드, 미디어 게시물을 동시에 예약할 수 있는 Buffer/Hootsuite 스타일의 도구를 구축할 수 있습니다.
LLM과 연동해 트윗, 뉴스 요약, 시장 업데이트 또는 AI 생성 이미지를 일정에 따라 또는 이벤트에 대응해 자동으로 생성하고 게시할 수 있습니다.
reply 매개변수를 사용해 브랜드 공식 핸들에서 고객 @-멘션이나 티켓과 연결된 트윗에 응답하는 지원 봇을 구축할 수 있습니다.
단일 "publish" 작업이 Twitter 및 기타 소셜 네트워크로 확산되는 더 넓은 CMS 또는 뉴스룸 워크플로에서 X를 출력 채널로 추가할 수 있습니다.
Twitter의 공식 POST /2/tweets 엔드포인트는 유료 Developer Account, OAuth 2.0 앱 설정을 요구하고 엄격한 티어 기반 속도 제한을 적용하는 반면, ApiPass는 사용한 만큼 지불하는 가격 정책과 가벼운 쿠키 기반 인증 모델을 통해 동일한 트윗 게시 기능을 제공합니다. 따라서 통합은 훨씬 빠르고, 확장은 더욱 비용 효율적입니다.
Twitter의 공식 POST /2/tweets 엔드포인트는 승인된 Developer Account, OAuth 2.0 앱 설정, 엄격한 월간 게시 한도가 있는 유료 구독 티어($200+/month)를 요구합니다. ApiPass는 로그인된 브라우저 세션에서 추출한 auth_token 쿠키(F12 → Application → Cookies → auth_token)와 단일 Bearer API key만 필요합니다. 앱 등록, OAuth callback URLs, 티어 제한이 없습니다.
Twitter의 공식 API는 사용량과 관계없이 고정 구독료와 함께 티어 기반 월간 게시 한도(Basic의 1,500/month, Pro의 300,000/month)를 적용합니다. ApiPass는 사용한 만큼 지불하는 방식으로 성공한 작업당 과금하며, channel 매개변수를 통해 비용과 안정성을 선택적으로 조정할 수 있습니다. starter 티어는 중요도가 낮은 워크로드에 매우 저렴하고, official은 네이티브 API에 준하는 가격과 안정성을 제공합니다.
속보, 가격 알림, 기상 경보 또는 시스템 상태 업데이트를 모니터링 파이프라인에서 브랜드 X 계정으로 실시간 직접 게시할 수 있습니다.
일일 AI 생성 이미지, 요약, 인용문 또는 스레드 형식의 글을 자동 게시해 수동 개입 없이 콘텐츠 중심 계정을 성장시킬 수 있습니다.
in_reply_to_tweet_id 매개변수를 사용해 멘션, 인용 트윗, 스레드 이어쓰기에 대규모로 응답하여 경품 봇, FAQ 응답기 또는 커뮤니티 관리 계정을 구동할 수 있습니다.
수십 개의 고객 계정을 관리하는 에이전시는 요청마다 AuthToken만 교체해 어떤 계정으로든 게시할 수 있으며, 모든 사용량은 하나의 ApiPass key 아래에서 통합 로깅과 함께 청구됩니다.
ApiPass에 가입하고 대시보드에서 API key를 생성하세요. 그런 다음 twitter.com을 열고 게시하려는 계정에 로그인한 뒤 DevTools(F12) → Application → Storage → Cookies를 열어 auth_token 쿠키 값을 복사합니다. 이 토큰은 ApiPass가 해당 특정 계정을 대신해 게시할 수 있도록 인증합니다.
Authorization 헤더에 Bearer token으로 ApiPass API key를 넣어 https://api.apipass.dev/api/v1/jobs/createTask 로 POST 요청을 보내세요. JSON 본문에서 model을 twitter/graphql/create-tweet으로 설정하고, input 객체 안에 AuthToken을 제공한 뒤, variables 객체에 최소한 tweet_text 필드를 입력합니다. 선택적으로 이미지 또는 동영상 첨부를 위한 media.media_entities, 답글 게시를 위한 reply.in_reply_to_tweet_id, 완료 시 서버 알림을 받기 위한 callBackUrl을 포함할 수 있습니다. 응답은 요청을 추적하는 데 사용할 수 있는 taskId를 반환합니다.
초기 요청에 callBackUrl을 제공해 트윗이 게시되었을 때 알림을 받거나, state가 success를 반환할 때까지 GET /api/v1/jobs/recordInfo?taskId={taskId} 를 폴링하세요. resultJson 필드에는 게시된 트윗 세부 정보가 포함됩니다. 가능한 작업 상태에는 waiting, queuing, generating, success, fail이 있으며, 디버깅이 필요한 경우 failCode와 failMsg가 함께 반환됩니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
트윗을 게시합니다.
API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "AuthToken": "string",
7 "variables": {
8 "tweet_text": "string",
9 "dark_request": "boolean",
10 "media": {
11 "media_entities": "[]",
12 "possibly_sensitive": "boolean",
13 },
14 "reply": {
15 "in_reply_to_tweet_id": "string",
16 "exclude_reply_user_ids": "[]",
17 },
18 "semantic_annotation_ids": "[]",
19 "includePromotedContent": "boolean",
20 }
21 }
22}model필수string생성에 사용할 모델 이름입니다.
"twitter/graphql/create-tweet"
callBackUrl선택적string작업 완료 알림을 받을 콜백 URL입니다. 생략하면 콜백이 전송되지 않습니다.
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이 제공업체들이 실제 이미지 및 동영상 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체 간에 작업을 자동으로 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 별도의 라우팅 요구 사항이 없다면 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
input 객체에는 다음 파라미터가 포함됩니다:
input.variables.tweet_text필수stringhello
input.variables.dark_request선택적booleanfalse
input.variables.media.media_entities선택적array[]
input.variables.media.possibly_sensitive선택적booleanfalse
input.variables.semantic_annotation_ids선택적array[]
input.variables.includePromotedContent선택적booleanfalse
variables.reply.in_reply_to_tweet_id선택적string123
variables.reply.exclude_reply_user_ids선택적string[]
input.AuthToken필수stringTwitter 홈페이지를 열고 로그인한 다음 F12 > Application > Storage > Cookies > auth_token으로 이동하세요.
YOUR_X_AUTH_TOKEN
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/create-tweet",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "AuthToken": "YOUR_X_AUTH_TOKEN",
9 "variables": {
10 "tweet_text": "hello",
11 "dark_request": false,
12 "reply": {
13 "in_reply_to_tweet_id": "123",
14 "exclude_reply_user_ids": []
15 },
16 "media": {
17 "media_entities": [
18 {
19 "media_id": "1869610428579606520",
20 "tagged_users": []
21 }
22 ],
23 "possibly_sensitive": false
24 },
25 "semantic_annotation_ids": [],
26 "includePromotedContent": false
27 }
28 }
29 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code상태 코드입니다. 200은 성공, 그 외 값은 실패를 의미합니다.
message응답 메시지입니다. 실패 시 오류 설명이 포함됩니다.
data.taskId작업 상태와 결과를 조회하기 위한 작업 ID입니다.
