canonical: https://jentic.com/apis/easydown.org/easydown

# EasyDown API

The EasyDown API parses public media URLs from social platforms into a normalized media format or full platform-specific data. Agents pass a post URL to the generic parse operation to get normalized media, or call a platform-specific operation to also receive the raw platform payload. It covers TikTok, Douyin, Toutiao, YouTube, Twitter/X, Instagram, Threads, Xiaohongshu, Bilibili, Kuaishou, and Weibo. Authentication uses a bearer EasyDown API token.

## For AI agents

Parse a public social media URL into normalized media or full platform-specific data across TikTok, YouTube, Twitter/X, Instagram, and more. Covers 13 operations spanning 11 platforms.

## Scope

Does not handle posting content, saving files to storage, or video transcoding. Use for parsing public media URLs into normalized media only.

## Capabilities

- Parse a public media URL into the normalized EasyDown media format
- Return full platform-specific data for a post alongside the normalized media
- Extract media from TikTok, Douyin, Kuaishou, and Bilibili posts
- Extract media from YouTube, Twitter/X, Instagram, and Threads posts
- Extract media from Weibo, Xiaohongshu, and Toutiao posts

## Use cases

### AI Agent Media Resolution

Let an AI agent turn a social post link into usable media on demand: it passes a public URL to the generic parse operation and receives the normalized media the post contains. Through Jentic the agent discovers the parse operation by intent and calls it with the URL, so an agent that is handed a link can resolve its media without a developer wiring each platform's quirks by hand.

Example prompt: Parse a TikTok post URL with the generic parse operation and return the normalized media URLs to the agent

### Cross-Platform Content Ingestion

Teams that collect posts from many networks want one shape of data regardless of source. The platform-specific parse operations return both the normalized media and the full platform payload for a given URL, so a pipeline can store the common fields and still keep the raw details. This covers short-video, image, and streaming platforms through a single API token.

Example prompt: Call the platform-specific parse operation for a YouTube URL to get both the normalized media and the full YouTube payload

### Chinese Social Platform Support

Many media APIs stop at Western platforms, leaving Chinese networks unresolved. EasyDown parses Weibo, Bilibili, Xiaohongshu, Douyin, Kuaishou, and Toutiao URLs into the same normalized media format as everything else. An agent can process a mixed feed of global and Chinese posts without branching its logic per region.

Example prompt: Parse a Xiaohongshu note URL and a Douyin video URL, returning normalized media for each

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/api/v1/parse` | Parse media into the normalized EasyDown format |
| POST | `/api/v1/platforms/{platform}/parse` | Parse media with normalized and full platform data |
| POST | `/api/v1/platforms/tiktok/parse` | Parse TikTok media |
| POST | `/api/v1/platforms/youtube/parse` | Parse YouTube media |
| POST | `/api/v1/platforms/instagram/parse` | Parse Instagram media |
| POST | `/api/v1/platforms/twitter/parse` | Parse Twitter / X media |
| POST | `/api/v1/platforms/bilibili/parse` | Parse Bilibili media |
| POST | `/api/v1/platforms/weibo/parse` | Parse Weibo media |

## Key resources

- **Normalized parse** — Parse any supported media URL into the normalized EasyDown media format
- **Platform parse** — Parse per-platform URLs for both normalized media and the full platform payload across 11 platforms

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 65 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 93 / 100
  - Developer Experience & Jentic Compatibility: 69 / 100
  - AI-Readiness & Agent Experience: 47 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 57 / 100
- **View full report:** https://jentic.com/apis/easydown.org/easydown/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring EasyDown by hand means managing its bearer token and learning each platform's parse endpoint and the difference between normalized media and the full platform payload. Through Jentic you install once, import EasyDown from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** EasyDown puts the platform in the URL path (`/api/v1/platforms/{platform}/parse`), so a rule can limit your agent to specific platforms such as YouTube or TikTok and the parse operations you pick. Every operation is a read-only parse, so there are no destructive operations to grant unless you add new ones later.
- **Credential handling:** Your EasyDown API token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'parse a TikTok video' or 'get media from a YouTube link', and Jentic returns the matching EasyDown operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Bright Data Web Scraper API** — General web and social data extraction at scale rather than URL parsing
- **ScrapingDog API** — Web scraping with social endpoints for extracting page content
- **Apify API** — Actor-based scraping and automation platform for larger extraction jobs
- **ScrapingAnt API** — Headless-browser scraping for pages EasyDown's parsers do not cover

## FAQ

### What authentication does the EasyDown API use?

The EasyDown API authenticates with a bearer token per its OpenAPI spec, sent as an Authorization header carrying your EasyDown API token. Through Jentic the token is stored encrypted by your own Jentic One instance and injected at call time, so it never enters the agent's context.

### Can I parse a TikTok URL with the EasyDown API?

Yes. The TikTok parse operation takes a public TikTok post URL and returns normalized media along with the full platform payload, and the same pattern works for Douyin, YouTube, Twitter/X, Instagram, Threads, Xiaohongshu, Bilibili, Kuaishou, and Weibo. The generic parse operation returns normalized media for any supported URL.

### What are the rate limits for the EasyDown API?

The OpenAPI spec does not specify rate limits; see https://easydown.org for current limits. Each parse call resolves a single URL, so processing many posts means one request per URL.

### Is there an EasyDown MCP server?

You don't need an MCP server to give your agent the EasyDown API. Jentic connects it directly from the API Directory: import it, store your API token once, and your agent calls operations like parsing a TikTok or YouTube URL. Operations are discovered on demand, so no extra server's tool definitions sit in your agent's context.

### Can I limit what my agent is allowed to do with the EasyDown API?

Yes. Because EasyDown addresses each platform through its own path, a rule can allow the agent to parse only specific platforms, such as YouTube and TikTok, and nothing else. Every operation is a read-only parse, so there are no destructive actions to grant, and each call the agent makes is logged.

### How do I parse a media URL with the EasyDown API through Jentic?

Search Jentic for 'parse a social media URL into media' to find the parse operation, pass the public post URL, and read the normalized media back. To run it on your own infrastructure, install Jentic One from its GitHub repo.