TwitterDown Agent API
AI 에이전트에서 사용할 수 있도록 X 공개 게시물에서 동영상 직접 링크와 메타데이터를 추출합니다.
처음에는 성공한 분석 10회가 무료입니다. 소유자가 요건을 충족하는 첫 계정 연결을 완료하면 누적 체험 한도가 성공한 분석 기준으로 최대 100회까지 늘어납니다.
| 월별 지갑 결제 분석 횟수(UTC) | 성공한 분석 1회당 요금(USD) |
|---|---|
| 1–1,000 | $0.02 |
| 1,001–10,000 | $0.01 |
| 10,001+ | $0.005 |
각 구간의 요금은 해당 구간의 이용량에 적용됩니다. 지갑 충전 금액은 $5.00, $20.00, $100.00 USD입니다. 지갑 잔액과 사용하지 않은 체험 분석 횟수는 만료되지 않습니다.
빠른 설정: 이 내용을 에이전트에 붙여넣으세요
아래 텍스트를 복사해 ChatGPT, Claude 또는 사용 중인 AI 에이전트에 붙여넣으세요. 에이전트가 직접 등록하고 분석을 시작하는 데 필요한 내용이 모두 들어 있습니다. 문서를 읽거나 가입 양식을 작성할 필요가 없습니다.
Use the TwitterDown Agent API to download Twitter/X videos for me.
Base URL: https://twitterdown.com
No sign-up form or email is needed. Registration is programmatic:
1. Get a proof-of-work challenge:
POST https://twitterdown.com/api/v1/register/challenge (no body)
It returns { challenge, difficulty, expires_at }. Challenges last 5 minutes.
2. Solve it: find a string "solution" (a decimal counter encoded as a string works)
such that the SHA-256 hash of challenge + ":" + solution starts with
"difficulty" zero bits.
3. Register:
POST https://twitterdown.com/api/v1/register
JSON body: { "challenge": "...", "solution": "..." }
It returns { account_id, api_key, recovery_token, quota_granted: 10 }.
Save api_key and recovery_token securely; they are shown only once.
Registration includes 10 free successful parses that never expire.
4. Parse a public X post:
POST https://twitterdown.com/api/v1/twitter
Headers: Authorization: Bearer <api_key>
Idempotency-Key: <a unique value per parse, 1-128 ASCII chars>
JSON body: { "url": "https://x.com/<user>/status/<id>" }
It returns direct video URLs and metadata. Only successful parses count.
Reusing the same Idempotency-Key replays the stored result without charging
again; if you receive 202, poll the status URL from the response.
Check balance and usage any time:
GET https://twitterdown.com/api/v1/account (same Bearer key).
Pricing, only after the free parses run out and I top up the wallet:
$0.02 per successful parse for the first 1,000 wallet-funded parses per UTC
month, $0.01 each for the next 9,000, then $0.005 each. Failed parses are free.
Balances never expire.
When I ask you to hand the account over to me, get a claim link:
POST https://twitterdown.com/api/v1/claim-token (Bearer key, no body)
It returns { claim_url }. Send that link to me privately and do not open it
yourself. When I open it and confirm, I can manage keys and top up, and the
free trial grows to up to 100 lifetime successful parses.
Full machine-readable spec: https://twitterdown.com/openapi.yaml시작하기
- 작업 증명 과제를 요청하고 해결한 뒤 등록하세요.
- 등록 시 받은 API 키와 복구 토큰을 저장하세요.
- Bearer 키와 Idempotency-Key 헤더로 X 공개 게시물을 분석하세요.
- 소유자가 키를 관리하고 충전할 수 있도록 계정 연결 링크를 비공개로 공유하세요.