Name: Video Downloader API for TikTok, Instagram & More | EasyDown
Brand: easydown
SKU: api-easydown-easydown-video-downloader-api
Availability: InStock
Author: API Market

bo zhang

# EasyDown Social Media Video Downloader API

## Overview

The EasyDown API turns the URL of a public social media post into structured media data. Send a post link from TikTok, Douyin, Toutiao, YouTube, X (Twitter), Instagram, Threads, Xiaohongshu, Bilibili, Kuaishou or Weibo and get back a normalized `media` object with the title, thumbnail, duration and direct video, image and audio URLs, plus the raw platform payload in `platformData`. You can call one unified endpoint that detects the platform, or a dedicated endpoint per platform.

It is built for developers of media tools, creator and social publishing apps, content archiving and analytics platforms, and automation or AI-agent workflows that need a reliable way to resolve public post links into playable media across many regional and global platforms.

## Features

*   **13 endpoints**: one unified parser, one parser with the platform in the path, and eleven dedicated platform parsers.
*   **11 platforms**: TikTok, Douyin, Toutiao, YouTube, X (Twitter), Instagram, Threads, Xiaohongshu, Bilibili, Kuaishou and Weibo.
*   **Normalized output**: every result has the same `media` shape with `platform`, `title`, `thumbnail`, `duration`, `videos`, `images` and `audios`.
*   **Video variants**: each video lists its URL, quality, MIME type, width, height and whether it has audio.
*   **Raw data when you need it**: the original platform payload is returned in `platformData`.
*   **Consistent errors**: failures return `status`, `msg` and a machine-readable `code`.
*   **Plans**: the free plan covers seven dedicated platform endpoints (TikTok, Douyin, Toutiao, X, Instagram, Bilibili and Weibo); paid plans include all 13 endpoints.

## Use Cases

*   **Creator tools**: let users paste a post link and preview or reuse their own content.
*   **Social publishing and analytics**: pull titles, thumbnails and durations for posts you track.
*   **Archiving**: store public posts your team is authorized to keep.
*   **Automation and AI agents**: resolve links from many platforms through one consistent response format.

## API Documentation

### Base URL

All requests go through the API.market proxy:

```
https://prod.api.market/api/v1/easydown/easydown-video-downloader-api
```

### Authentication

Authenticate every request with your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Parse any supported URL

Detects the platform from the link and parses it. Use this when your app receives links from several platforms. Available on paid plans.

**Method:** `POST`

**Endpoint:** `/api/v1/parse`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| url | body | Public post URL to parse | string | Yes (or `link`) | - | - |
| link | body | Alias for `url`, kept for compatibility | string | No | - | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/easydown/easydown-video-downloader-api/api/v1/parse' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://www.tiktok.com/@scout2015/video/6718335390845095173"}'
```

#### 2. Parse with the platform in the path

Same as above, but you name the platform in the path. Available on paid plans.

**Method:** `POST`

**Endpoint:** `/api/v1/platforms/{platform}/parse`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| platform | path | One of `tiktok`, `douyin`, `toutiao`, `youtube`, `twitter`, `instagram`, `threads`, `xiaohongshu`, `bilibili`, `kuaishou`, `weibo` | string | Yes | - | - |
| url | body | Public post URL to parse | string | Yes (or `link`) | - | - |
| link | body | Alias for `url` | string | No | - | - |

#### 3. Dedicated platform parsers

Each platform also has its own fixed route with the same body (`url` or `link`) and the same response format:

| Platform | Endpoint | Free plan |
|---|---|---|
| TikTok | `POST /api/v1/platforms/tiktok/parse` | Yes |
| Douyin | `POST /api/v1/platforms/douyin/parse` | Yes |
| Toutiao | `POST /api/v1/platforms/toutiao/parse` | Yes |
| X (Twitter) | `POST /api/v1/platforms/twitter/parse` | Yes |
| Instagram | `POST /api/v1/platforms/instagram/parse` | Yes |
| Bilibili | `POST /api/v1/platforms/bilibili/parse` | Yes |
| Weibo | `POST /api/v1/platforms/weibo/parse` | Yes |
| YouTube | `POST /api/v1/platforms/youtube/parse` | Paid plans |
| Threads | `POST /api/v1/platforms/threads/parse` | Paid plans |
| Xiaohongshu | `POST /api/v1/platforms/xiaohongshu/parse` | Paid plans |
| Kuaishou | `POST /api/v1/platforms/kuaishou/parse` | Paid plans |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/easydown/easydown-video-downloader-api/api/v1/platforms/tiktok/parse' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://www.tiktok.com/@scout2015/video/6718335390845095173"}'
```

**Example Response (200 OK):**

Long URLs and the title are shortened, only two video variants are shown, and the raw `platformData` payload is omitted.

```json
{
  "status": 200,
  "data": {
    "media": {
      "platform": "tiktok",
      "title": "Scramble up ur name & I’ll try to guess it😍❤️ #foryoupage #...",
      "thumbnail": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/2...",
      "duration": 11,
      "images": [],
      "videos": [
        {
          "url": "https://v16m.tiktokcdn-us.com/df2beff16c98a03a02494c3e5e7bde...",
          "quality": "Standard",
          "mimeType": "video/mp4",
          "width": 576,
          "height": 1024,
          "hasAudio": true,
          "source": "direct",
          "headers": {}
        },
        {
          "url": "https://v19.tiktokcdn-us.com/dfc0bfa62f2d6c45642946cbb3e3fd4...",
          "quality": "Standard",
          "mimeType": "video/mp4",
          "width": 576,
          "height": 1024,
          "hasAudio": true,
          "source": "direct",
          "headers": {}
        }
      ],
      "audios": []
    },
    "platformData": {
      "...": "raw platform payload"
    },
    "platformDataVersion": "1"
  },
  "msg": "success"
}
```

**Example Error Response (404):**

```json
{
  "status": 404,
  "data": null,
  "msg": "The content is unavailable",
  "code": "content_unavailable"
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The post was parsed. `data.media` holds the normalized media. |
| 400 | Bad Request | The body is invalid or the URL is missing or malformed. The API.market gateway also returns 400 "API Path invalid or doesn't exist" when your plan does not include the endpoint (for example YouTube on the free plan). |
| 401 | Unauthorized | The `x-api-market-key` header is missing or invalid. |
| 403 | Forbidden | Your API.market plan does not allow this request. |
| 404 | Not Found | The post is private, removed, region-restricted or unavailable (`content_unavailable`). |
| 429 | Too Many Requests | You exceeded your plan's rate limit. Wait and retry. |
| 500 | Internal Server Error | Unexpected error. Retry the request. |
| 503 | Service Unavailable | The platform service is temporarily unavailable (`upstream_unavailable`). Retry after a short wait. |

## Rate Limits

The free plan allows 1 request per second and the paid plans allow 10 requests per second. Requests above your limit return `429 Too Many Requests`. Throttle your calls, back off on a 429, and honour the `Retry-After` header when it is present.

## FAQ

*   **Should I use the unified endpoint or a dedicated one?**

    Use `/api/v1/parse` when links can come from any platform. Use a dedicated endpoint when you already know the platform, or when you are on the free plan, which includes seven dedicated endpoints.

*   **How long do the media URLs work?**

    They are signed CDN URLs from the platform and expire after a while. Download or process the media soon after parsing.

*   **Why is a video missing or the result a 404?**

    Private, removed, region-restricted and login-only posts cannot be parsed. Only public posts are supported.

*   **What is `platformData`?**

    The original payload from the platform, for fields that are not in the normalized `media` object. Its structure differs per platform.

*   **Can I download any content?**

    Only parse and use content you are authorized to use, and respect creators' rights and each platform's terms.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Parse public TikTok, Instagram, X, Threads, Bilibili and other post URLs into structured media metadata with the EasyDown developer API.

Video Downloader API for TikTok, Instagram & More | EasyDown

Free