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
Weibo weibo 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
Reddit reddit English forum community
X x Social media platform
Facebook facebook 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