Video Download API documentation

EasyDown REST API platform guide

Toutiao Video Download API

The numeric-looking group ID stays a string through the REST workflow so large identifiers cannot lose precision before the Toutiao video lookup.

Use the EasyDown Toutiao Video Download API for public /video/{id} pages and receive every main and backup video stream plus content image candidates.

Toutiao download API · Toutiao video parser API

Production REST endpoint

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

Supported public URL formats

toutiao.com/video/{id}www.toutiao.com/video/{id}m.toutiao.com/video/{id}

Real request example

https://www.toutiao.com/video/7613611314560369152/

curl -X POST https://api.easydown.org/api/v1/parse \
  -H "Authorization: Bearer ed_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.toutiao.com/video/7613611314560369152/"}'

Platform response example

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

Media behavior

Every video-list item can contribute both main and backup URLs. First frames, covers, and content thumbnails remain available in images[] for product previews.

{
  "status": 200,
  "data": {
    "platform": "toutiao",
    "title": "Example toutiao 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

Use Referer: https://www.toutiao.com/, a browser User-Agent, and forwarded Range headers. Stream the selected main or backup URL from your backend and re-parse after expiration.

Recommended backend request headers

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

Unsupported or unavailable content

Articles, group pages, profiles, search pages, channels, short links, live pages, private content, and URLs without one video ID 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

Keep the group ID as a string in JavaScript and database columns.

Try a backup URL when the selected main stream is unavailable.

Submit a /video/{id} page rather than an article or group URL.

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 Toutiao URLs does the download API support?

Supported public single-post formats include toutiao.com/video/{id}, www.toutiao.com/video/{id}, m.toutiao.com/video/{id}. Articles, group pages, profiles, search pages, channels, short links, live pages, private content, and URLs without one video ID are unsupported.

What media does the Toutiao Download API return?

Every video-list item can contribute both main and backup URLs. First frames, covers, and content thumbnails remain available in images[] for product previews.

How should my application download returned Toutiao media URLs?

Use Referer: https://www.toutiao.com/, a browser User-Agent, and forwarded Range headers. Stream the selected main or backup URL from your backend and re-parse after expiration.

How is a successful Toutiao 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.