Download a social media post
download_socialGet the video and photos of a social media post (X/Twitter, Douyin, Xiaohongshu/RedNote, Instagram) as
direct download URLs, in one call. Use it whenever the user shares such a link or asks about a post's video or
pictures: to save, watch, transcribe, describe or analyze them. The files are small (short videos, photos):
fetch the URLs and work on them directly (at most 3 at once; resume a cut download with an HTTP Range request).
A post with several photos or videos returns them all (up to 20, items) and counts as one free download;
social posts have their own free allowance (20 a day).
Files not ready within `wait_seconds` have status "running" and a `job_id`: call `get_job`, then
`get_download_link`.Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "download_social"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Link to a post on X (Twitter), Douyin, Xiaohongshu (RedNote) or Instagram, as the user gave it | |
| tier | No | "free" (own daily allowance for social posts) or "fast" (uses traffic balance) | free |
| wait_seconds | No | How long to wait for the files to be ready |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||