¶ Introduction
The Publisher Publish API is an automated content publishing interface provided by Ace Data Cloud. Through this API, you can publish articles to multiple platforms with one click, including Zhihu, CSDN, Medium, Dev.to, Reddit, Weibo, Xiaohongshu, and 13 other mainstream content platforms.
¶ Features
- Multi-platform publishing: Publish content to multiple platforms with a single request
- Multi-format support: Supports Markdown, HTML, and plain text formats
- AI content optimization: Optionally enable AI to automatically adapt to the styles of each platform
- Asynchronous tasks: Query progress through the Tasks API after submitting a task
- Callback notifications: Supports setting a callback URL to automatically notify upon completion of publishing
¶ Basic Usage
¶ Publish to Multiple Platforms
curl -X POST 'https://api.acedata.cloud/publisher/publish' \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"title": "Introduction to AI APIs",
"content": "# Introduction\n\nThis article covers...",
"content_format": "markdown",
"channels": ["zhihu", "medium", "csdn"]
}'
¶ Response Example
{
"success": true,
"task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab",
"data": [
{
"task_id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
"channel": "zhihu",
"state": "pending"
},
{
"task_id": "a9b8c7d6-e5f4-3210-abcd-ef1234567890",
"channel": "medium",
"state": "pending"
}
]
}
¶ Enable AI Content Optimization
curl -X POST 'https://api.acedata.cloud/publisher/publish' \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"title": "AI API User Guide",
"content": "# Guide\n\nThis article introduces how to use the AI API...",
"channels": ["xiaohongshu", "medium"],
"generate": true
}'
After setting generate: true, the system will use AI to generate content versions suitable for each platform's style.
¶ Supported Platforms
| Platform | channel value | Description |
|---|---|---|
| Zhihu | zhihu | Chinese Q&A community |
| CSDN | csdn | Chinese tech community |
| Bilibili | bilibili | Video and article platform |
| Baijiahao | baijiahao | Baidu content platform |
| Xiaohongshu | xiaohongshu | Lifestyle community |
| Chinese social platform | ||
| Toutiao | toutiao | Today's headlines content platform |
| Juejin | juejin | Chinese tech community |
| Medium | medium | English blogging platform |
| Dev.to | dev | English tech community |
| English forum community | ||
| X | x | Social media platform |
| Social media platform |
¶ Notes
- You need to configure the login credentials for the target platform through the Configs API before publishing
- Each task is executed asynchronously; please use the Tasks API to check the publishing status
- It is recommended to check the available platform list using the Channels API before publishing
