Video Download API documentation

EasyDown REST API platform guide

Weibo Media Download API

Desktop, mobile status/detail, visitor, and t.cn links use the post workflow. Weibo video-show links with a 1034 object ID first use the public component endpoint and only enter the existing post fallbacks when component media is unavailable.

Use the EasyDown Weibo Media Download API to parse public posts, mobile status URLs, video-show links, and short links into complete video, image, gallery, and cover data.

Weibo video download API · Weibo image API

Production REST endpoint

POST https://api.easydown.org/api/v1/parse

Supported public URL formats

weibo.com/{uid}/{postId}m.weibo.cn/status/{id}m.weibo.cn/detail/{id}weibo.com/tv/show/1034:{objectId}h5.video.weibo.com/show/1034:{objectId}video.weibo.com/show?fid=1034:{objectId}t.cn/{code}mapp.api.weibo.cn/fx/...Share text containing a Weibo URL

Real request example

https://video.weibo.com/show?fid=1034:5324152400445628

curl -X POST https://api.easydown.org/api/v1/parse \
  -H "Authorization: Bearer ed_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://video.weibo.com/show?fid=1034:5324152400445628"}'

Platform response example

The shared envelope stays stable while this platform determines which media arrays and attributes are populated.

Media behavior

Video posts and component video pages keep every available playback quality and cover. Image posts return every original image discovered in the target gallery.

{
  "status": 200,
  "data": {
    "platform": "weibo",
    "title": "Example weibo public post",
    "thumbnail": "https://cdn.example.com/thumbnail.jpg",
    "duration": 24,
    "images": [
      {
        "url": "https://cdn.example.com/content-image.jpg",
        "width": 1080,
        "height": 1350
      }
    ],
    "videos": [
      {
        "url": "https://cdn.example.com/video.mp4",
        "quality": "HD",
        "mimeType": "video/mp4",
        "width": 1080,
        "height": 1920,
        "hasAudio": true,
        "source": "direct"
      }
    ],
    "audios": []
  },
  "msg": "success"
}

Download and proxy rules

The EasyDown website routes every Weibo media download through its proxy. REST clients should likewise use a backend proxy with a Weibo Referer, browser User-Agent, and forwarded Range header, then re-parse expired source URLs.

Recommended backend request headers

User-Agent: Mozilla/5.0 Referer: https://weibo.com/ Range: bytes=0-

Unsupported or unavailable content

Profiles, personal video tabs, search pages, topics, super topics, articles, live pages, collections, private posts, and deleted posts are unsupported.

Only process public media you have the right to use. EasyDown does not bypass privacy controls, DRM, deleted content, or platform access restrictions.

Platform-specific troubleshooting

Normalize t.cn links before caching a post identifier.

Choose a playback entry by quality metadata rather than relying on array order.

Re-parse image or video URLs after the source signature expires.

REST integration workflow

  1. 1

    Create a private API token and allow this platform in its permissions.

  2. 2

    POST one complete public post URL to the shared endpoint.

  3. 3

    Select and proxy the required items from images, videos, and audios.

Download API questions

Which Weibo URLs does the download API support?

Supported public single-post formats include weibo.com/{uid}/{postId}, m.weibo.cn/status/{id}, m.weibo.cn/detail/{id}, weibo.com/tv/show/1034:{objectId}, h5.video.weibo.com/show/1034:{objectId}, video.weibo.com/show?fid=1034:{objectId}, t.cn/{code}, mapp.api.weibo.cn/fx/..., Share text containing a Weibo URL. Profiles, personal video tabs, search pages, topics, super topics, articles, live pages, collections, private posts, and deleted posts are unsupported.

What media does the Weibo Download API return?

Video posts and component video pages keep every available playback quality and cover. Image posts return every original image discovered in the target gallery.

How should my application download returned Weibo media URLs?

The EasyDown website routes every Weibo media download through its proxy. REST clients should likewise use a backend proxy with a Weibo Referer, browser User-Agent, and forwarded Range header, then re-parse expired source URLs.

How is a successful Weibo API request billed?

A response containing at least one image, video, or audio URL costs 1 credit. Failed, unsupported, authentication, and empty-media results do not consume credits.