RelayAPI
Tools

Download Twitter/X media

Returns available formats and direct download URL. Responds with 200 if the result is ready immediately, or 202 with a job_id to poll if processing takes longer. Rate limited by daily tool quota.

POST
/v1/tools/twitter/download

Authorization

Bearer
AuthorizationBearer <token>

API key (rlay_live_* or rlay_test_). Invite redemption also accepts a server-derived rlay_session_ bearer for a current user session.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/tools/twitter/download" \  -H "Content-Type: application/json" \  -d '{    "url": "http://example.com"  }'
{  "author": "string",  "download_url": "string",  "duration": 0,  "formats": [    {      "ext": "string",      "filesize": 0,      "format_id": "string",      "resolution": "string",      "url": "string"    }  ],  "platform": "string",  "success": true,  "thumbnail": "string",  "title": "string"}

Found something wrong? Help us improve this page.

Report an issueEdit this page on GitHub

Download TikTok video POST

Returns available formats and direct download URL. Responds with 200 if the result is ready immediately, or 202 with a job_id to poll if processing takes longer. Rate limited by daily tool quota.

Download YouTube video POST

Returns available formats and direct download URL. Responds with 200 if the result is ready immediately, or 202 with a job_id to poll if processing takes longer. Rate limited by daily tool quota.