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

시작하기

  1. 작업 증명 과제를 요청하고 해결한 뒤 등록하세요.
  2. 등록 시 받은 API 키와 복구 토큰을 저장하세요.
  3. Bearer 키와 Idempotency-Key 헤더로 X 공개 게시물을 분석하세요.
  4. 소유자가 키를 관리하고 충전할 수 있도록 계정 연결 링크를 비공개로 공유하세요.