TwitterDown Agent API

Resolve public X posts into direct video links and metadata for your AI agent.

Start with 10 free successful parses. A first eligible owner claim brings the lifetime trial to up to 100 successful parses.

Wallet-funded parses per UTC monthUSD per successful parse
1–1,000$0.02
1,001–10,000$0.01
10,001+$0.005

Each tier applies to usage within that tier. Wallet top-ups are $5.00, $20.00, $100.00 USD. Balance and unused trial parses never expire.

Fastest setup: paste this to your agent

Copy the text below and paste it into ChatGPT, Claude or any AI agent. It contains everything the agent needs to register itself and start parsing — no reading docs, no sign-up form.

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

Get started

  1. Request a proof-of-work challenge, solve it and register.
  2. Save the API key and recovery token when registration returns them.
  3. Parse a public X post with your Bearer key and an Idempotency-Key.
  4. Share a claim link privately with your owner so they can manage keys and top up.