接口文档

注册并审核通过后，在「首页 - API信息」获取你自己的 api_key，即可用 api_key 调用本站全部接口。本站按下方《收费明细》计费，调用成功才扣费，失败不扣。

接口根地址：https://www.xcxds.cn/addons/wwh/openapi　请求方式统一 POST　返回统一为 {code, msg, time, data}，code=1 表示成功。

收费明细

平台采用「算力计费 + 按量计费」双模式，透明计费、据实扣除。

一、收录查询服务

单次查询单个问题 / 单个平台收录状态，消耗 1 算力/次

二、官媒发布服务

按照对应文章资源实际定价据实消耗，最终费用以接口返回结算数据为准。调用投稿时请同时传 price（媒体列表中的价格）。

三、AI 品牌可见度诊断服务

3.1 标准版（内部专属，暂不对外开放）
无优化建议报告：300 算力/次；含全套优化建议报告：350 算力/次

3.2 PRO 专业版
品牌初步数据分析：5 算力/次；生成完整专业诊断报告：400 算力/次

四、B2B 全网发布服务（按篇计费）

全平台智能分发，一键批量发布，单价透明统一。投稿只需传 type，本站按 type 对应的单价扣款。

type	媒体	单价	说明
1	黄页88	1.00 元/篇
2	搜了网	1.00 元/篇	平台开店免费
3	博客园	3.00 元/篇
4	列举网	0.80 元/篇	需传 author、phone，可选 area 地区ID
5	商业新知	3.00 元/篇
6	蓝色河畔	3.00 元/篇
7	八方资源	1.00 元/篇	一次性开店服务费 10 元
8	土山兔	46.00 元/篇

五、智能视频合成服务

1 算力 / 100 字符，不足 100 按 100 计。对应接口暂未开放。

通用说明

请求方式	统一 `POST`，地址为 `https://www.xcxds.cn/addons/wwh/openapi/接口名`
Content-Type	`application/x-www-form-urlencoded`（也支持 `multipart/form-data`）
身份验证	每个请求带 `api_key`，也可放在请求头 `api-key` 中
返回格式	JSON，UTF-8，结构 `{code, msg, time, data}`；`code` 为 `1` 成功、`0` 失败
扣费时机	仅 `code=1` 时扣费；参数错误、审核未通过、服务异常等均不扣费
算力 / 余额	查收录、AI 诊断按算力扣；媒体投稿、B2B 按余额（元）扣。可在首页或 `get_balance` 查询
超时建议	常规接口 30 秒；`preAnalyze` 建议 60 秒；`downloadReports` 建议 180 秒
轮询建议	查收录进度、报告状态建议每 10~30 秒轮询一次，不要高频轮询

PHP 调用示例（通用）

 true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 60,
        CURLOPT_POSTFIELDS     => http_build_query($params),
    ]);
    $body = curl_exec($ch);
    if (curl_errno($ch)) {
        curl_close($ch);
        return ['code' => 0, 'msg' => '请求失败', 'data' => null];
    }
    curl_close($ch);
    return json_decode((string)$body, true) ?: ['code' => 0, 'msg' => '返回解析失败', 'data' => null];
}

// 1）提交查收录任务
$res = wwhApi('add_shoulu', [
    'platform' => 1,
    'keywords' => '蓝春科技',
    'question' => 'geo优化软件源码搭建哪家好',
]);
if ($res['code'] != 1) {
    exit('失败：' . $res['msg']);
}
$requestId = $res['data']['request_id'];

// 2）轮询任务进度
$task = wwhApi('check_task', ['request_id' => $requestId]);
var_dump($task['data']);

GEO查收录

POST 新建查询任务

提交一个查收录任务。提交成功即扣 1 算力，扣费在返回 code=1 时进行，失败不扣。

POST https://www.xcxds.cn/addons/wwh/openapi/add_shoulu 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥，注册并审核通过后在「首页 - API信息」获取	sk_xxxxxxxx
platform	integer	必需	AI 平台：1-DeepSeek，2-豆包（临时下架），3-元宝，4-千问，5-文心一言，6-纳米，7-Kimi，8-智谱	1
keywords	string	必需	品牌词，多个用英文逗号隔开	蓝春科技,蓝春
question	string	必需	查询问题	geo优化软件源码搭建哪家好
third_id	string	可选	建议传你自己系统的用户ID，方便对账查单	u10086

返回说明（`data` 字段）

字段	类型	说明	示例
request_id	string	任务ID，后续用它查进度	694b5afab6f202

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/add_shoulu' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'platform=1' \
  -d 'keywords=蓝春科技,蓝春' \
  -d 'question=geo优化软件源码搭建哪家好' \
  -d 'third_id=u10086'

返回示例

{"code":1,"msg":"添加任务成功，请耐心等待查询结果","time":"1766546170","data":{"request_id":"694b5afab6f202"}}

POST 获取任务进度

查询单个任务的查询进度与结果。不扣费。

POST https://www.xcxds.cn/addons/wwh/openapi/check_task 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
request_id	string	必需	新建查询任务返回的任务ID	694b5afab6f202

返回说明（`data` 字段）

字段	类型	说明	示例
request_id	string	任务ID	694b58af6f2eb2
status	integer	查询状态：0-查询中，1-已收录，2-未收录，3-查询失败已退款	0
question	string	查询问题	geo优化软件源码搭建哪家好
hit_word	string	命中的品牌词	科技
keyword_res	string	命中词详情
platform	integer	AI 平台，取值同新建任务	2
shoulu_date	string	收录日期，格式 2025-12-12，未收录时为空
script_time	integer	最后查询时间戳	0
share_url	string	查询结果分享链接
img_url	string	查询结果截图

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/check_task' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'request_id=694b5afab6f202'

返回示例

{"code":1,"msg":"查询成功","time":"1766547260","data":{"request_id":"694b58af6f2eb2","status":0,"question":"geo优化软件源码搭建哪家好","hit_word":"科技","keyword_res":"","platform":2,"shoulu_date":"","script_time":0,"share_url":"","img_url":""}}

POST 取消查询任务

取消尚未出结果的任务并退回算力。已进入排队或已出结果的任务不支持退款。

POST https://www.xcxds.cn/addons/wwh/openapi/cancel_task 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
request_ids	string	必需	任务ID，多个用英文逗号分隔	6964bded38a732,6964bded38a733

返回说明（`data` 字段）

字段	类型	说明	示例
data	array	成功取消的任务ID数组，全部失败时为 null	["6964bded38a732"]

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/cancel_task' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'request_ids=6964bded38a732,6964bded38a733'

返回示例

{"code":1,"msg":"取消成功","time":"1767877762","data":["6964bded38a732"]}

网站媒体

POST 媒体资源列表

拉取可投稿的网站媒体及其价格。不扣费。price 即投稿时本站的扣款金额。

POST https://www.xcxds.cn/addons/wwh/openapi/media_list 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
page	integer	可选	页码，默认 1	1
page_size	integer	可选	每页条数，默认 20	20

返回说明（`data` 字段）

字段	类型	说明	示例
resource_id	integer	媒体ID，投稿时作为 resource_id 传入	73880
title	string	媒体名称	中华网生活
remarks	string	媒体备注（投稿要求、注意事项）	图片涉及侵犯版权问题默认删，修改敏感词不通知
case_link	string	案例链接	http://life.china.com/2020-09/20/content_334.html
price	string	媒体价格（元）	27.00
status	integer	接单状态：1-可接单，0-暂停接单	1
pc_weigh	string	PC 权重	2
wap_weigh	string	移动权重	2
publish_rate	string	出稿率（%），可能为 null	75
publish_time	integer	平均发布时间（秒）	7777
field_1	string	筛选条件1：行业领域，取值见「媒体分类」	1014
field_2	string	筛选条件2：综合门户，可能为 null	2027
field_3	string	筛选条件3：所在地区	3001
field_4	string	筛选条件4：入口级别	4001
field_5	string	筛选条件5：收录情况	5002
field_6	string	筛选条件6：链接类型	6001
field_7	string	筛选条件7：发稿速度	7024
field_8	string	筛选条件8：特殊行业，可能为 null
field_9	string	筛选条件9：高级选项，多个用英文逗号分隔	9001,9002,9003

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/media_list' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'page=1' \
  -d 'page_size=20'

返回示例

{"code":1,"msg":"获取成功","time":"1768275264","data":[{"resource_id":73880,"title":"中华网生活","remarks":"图片涉及侵犯版权问题默认删修改敏感词不通知。","case_link":"http://life.china.com/2020-09/20/content_334.html","field_1":"1014","field_3":"3001","field_5":"5002","field_6":"6001","pc_weigh":"2","wap_weigh":"2","publish_rate":"75","publish_time":7777,"field_2":"2027","field_4":"4001","field_7":"7024","field_8":null,"field_9":"9001,9002,9003","status":1,"price":"27.00"}]}

POST 投稿媒体

向指定媒体投稿发布文章。按该媒体的实际定价扣余额，扣费在返回 code=1 时进行，失败不扣。

POST https://www.xcxds.cn/addons/wwh/openapi/media_send 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
resource_id	string	必需	媒体ID，来自媒体资源列表	73880
title	string	必需	文章标题	2026年GEO优化软件怎么选
content	string	必需	文章正文，HTML 格式	<p>正文内容……</p>
price	string	必需	该媒体的定价，原样传媒体列表里的 price，用于扣款核对	27.00
remark	string	可选	投稿备注	周末可发
third_id	string	可选	建议传你自己系统的用户ID，方便对账	u10086

返回说明（`data` 字段）

字段	类型	说明	示例
order_nid	string	稿件订单号，用于查询订单状态	2026011317430600129457

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/media_send' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'resource_id=73880' \
  -d 'title=2026年GEO优化软件怎么选' \
  -d 'content=<p>正文内容……</p>' \
  -d 'price=27.00' \
  -d 'remark=周末可发' \
  -d 'third_id=u10086'

返回示例

{"code":1,"msg":"投稿成功","time":"1768295083","data":{"order_nid":123}}

POST 投稿订单详情

查询投稿订单的状态与结果链接。不扣费。

POST https://www.xcxds.cn/addons/wwh/openapi/media_order 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
order_nids	string	必需	订单号，多个用英文逗号分隔	2026011317430600129457

返回说明（`data` 字段）

字段	类型	说明	示例
order_nid	string	订单号	2026011317430600129457
resource_id	string	媒体ID	15707
status	integer	订单状态：0-待安排，1-已安排，2-已发布，4-已退稿，9-售后中	4
price	string	订单金额	2.00
is_refund	integer	是否已退款：1-已退款，0-未退款	1
title	string	文章标题	示例标题
remark	string	投稿备注
order_url	string	文章发布后的结果链接
rejection_info	string	拒稿原因
refund_info	string	退稿原因
rewrite_info	string	改稿原因

批量查询时 data 为订单数组；单条查询时 data 为单个订单对象。

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/media_order' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'order_nids=2026011317430600129457'

返回示例

{"code":1,"msg":"获取成功","time":"1768308511","data":{"resource_id":"15707","order_nid":"2026011317430600129457","status":4,"price":"2.00","is_refund":1,"title":"123","remark":"","rejection_info":"","refund_info":"","rewrite_info":""}}

POST 取消投稿订单

取消尚未开始处理的投稿订单并退款。

POST https://www.xcxds.cn/addons/wwh/openapi/cancel_order 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
order_nid	string	必需	订单号	2026011317430600129457

返回说明

成功时 data 为 null，以 code 与 msg 为准。

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/cancel_order' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'order_nid=2026011317430600129457'

返回示例

{"code":1,"msg":"取消成功","time":"1768492661","data":null}

POST 媒体分类

拉取媒体筛选条件的分类字典，用于把媒体列表里的 field_1 ~ field_9 翻译成可读名称。

POST https://www.xcxds.cn/addons/wwh/openapi/get_field 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
media_type	string	必需	媒体类型：website-网站媒体，wemedia-自媒体	website
field_type	string	可选	分类维度：field_1 行业领域、field_2 综合门户、field_3 所在地区、field_4 入口级别、field_5 收录情况、field_6 链接类型、field_7 发稿速度、field_8 特殊行业、field_9 高级选项	field_1

返回说明（`data` 字段）

字段	类型	说明	示例
field_id	string	分类ID，对应媒体列表里 field_x 的值	1014
field_type	string	所属分类维度	field_1
field_title	string	分类名称	生活消费
rsort	integer	排序，从小到大	14

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/get_field' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'media_type=website' \
  -d 'field_type=field_1'

返回示例

{"code":1,"msg":"获取成功","time":"1768318475","data":[{"field_id":"1001","field_type":"field_1","field_title":"IT科技","rsort":1},{"field_id":"1014","field_type":"field_1","field_title":"生活消费","rsort":14}]}

第三方自媒体

POST 媒体资源列表

拉取可投稿的自媒体账号及价格。不扣费。请求与返回字段与「网站媒体 · 媒体资源列表」完全一致，仅数据源不同。

POST https://www.xcxds.cn/addons/wwh/openapi/zi_media_list 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
page	integer	可选	页码，默认 1	1
page_size	integer	可选	每页条数，默认 20	20

返回说明（`data` 字段）

字段	类型	说明	示例
resource_id	integer	媒体ID，投稿时作为 resource_id 传入	868022
title	string	媒体名称	山东商报（速豹新闻）
remarks	string	媒体备注	省级媒体，发布快，周末及节假日可发
case_link	string	案例链接
price	string	媒体价格（元）	18.00
status	integer	接单状态：1-可接单，0-暂停接单	1
pc_weigh	string	PC 权重	0
wap_weigh	string	移动权重	0
publish_rate	string	出稿率（%），可能为 null
publish_time	integer	平均发布时间（秒）
field_1 ~ field_9	string	筛选条件，取值见「媒体分类」（自媒体的维度名称略有不同，用 media_type=wemedia 拉取）

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/zi_media_list' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'page=1' \
  -d 'page_size=20'

返回示例

{"code":1,"msg":"获取成功","time":"1768275264","data":[{"resource_id":868022,"title":"山东商报（速豹新闻）","remarks":"省级媒体，发布快，周末及节假日可发，稍作改动不通知","case_link":"","status":1,"price":"18.00"}]}

POST 投稿媒体

向自媒体账号投稿。按该媒体的实际定价扣余额，扣费在返回 code=1 时进行，失败不扣。

POST https://www.xcxds.cn/addons/wwh/openapi/zi_media_send 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
resource_id	string	必需	媒体ID，来自自媒体资源列表	868022
title	string	必需	文章标题	示例标题
content	string	必需	文章正文，HTML 格式	<p>正文内容……</p>
price	string	必需	该媒体的定价，原样传自媒体列表里的 price，用于扣款核对	18.00
remark	string	可选	投稿备注
third_id	string	可选	建议传你自己系统的用户ID，方便对账	u10086

返回说明（`data` 字段）

字段	类型	说明	示例
order_nid	string	稿件订单号	2026011317430600129457

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/zi_media_send' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'resource_id=868022' \
  -d 'title=示例标题' \
  -d 'content=<p>正文内容……</p>' \
  -d 'price=18.00' \
  -d 'remark=<remark>' \
  -d 'third_id=u10086'

返回示例

{"code":1,"msg":"投稿成功","time":"1768295083","data":{"order_nid":123}}

POST 投稿订单详情

查询自媒体投稿订单状态。不扣费。字段同「网站媒体 · 投稿订单详情」。

POST https://www.xcxds.cn/addons/wwh/openapi/zi_order_info 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
order_nids	string	必需	订单号，多个用英文逗号分隔	2026011317430600129457

返回说明（`data` 字段）

字段	类型	说明	示例
order_nid	string	订单号	2026011317430600129457
resource_id	string	媒体ID	15707
status	integer	订单状态：0-待安排，1-已安排，2-已发布，4-已退稿，9-售后中	4
price	string	订单金额	2.00
is_refund	integer	是否已退款：1-已退款，0-未退款	1
title	string	文章标题	123
remark	string	投稿备注
order_url	string	文章结果链接
rejection_info	string	拒稿原因
refund_info	string	退稿原因
rewrite_info	string	改稿原因

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/zi_order_info' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'order_nids=2026011317430600129457'

返回示例

{"code":1,"msg":"获取成功","time":"1768308511","data":{"resource_id":"15707","order_nid":"2026011317430600129457","status":4,"price":"2.00","is_refund":1,"title":"123","remark":"","rejection_info":"","refund_info":"","rewrite_info":""}}

POST 投稿订单申诉

已完成的订单才可申诉，申诉进入审核，审核通过自动退款。

POST https://www.xcxds.cn/addons/wwh/openapi/zi_appeal 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
order_nid	string	必需	订单号	2026011317430600129457
title_id	integer	必需	申诉原因：1-未收录申请退款（包收录资源），2-发布（账号）结果与案例不一致，3-时效内链接打不开，4-未收录申请退款（包收录资源）	1
info	string	可选	具体原因说明	链接已打不开，附截图说明

返回说明

成功时 data 为 null，以 code 与 msg 为准。

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/zi_appeal' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'order_nid=2026011317430600129457' \
  -d 'title_id=1' \
  -d 'info=链接已打不开，附截图说明'

返回示例

{"code":1,"msg":"申诉成功","time":"1768316463","data":null}

POST 媒体分类

拉取自媒体的筛选条件分类字典。

POST https://www.xcxds.cn/addons/wwh/openapi/zi_get_field 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
media_type	string	可选	固定传 wemedia，不传默认即 wemedia	wemedia
field_type	string	可选	分类维度：field_1 ~ field_9	field_1

返回说明（`data` 字段）

字段	类型	说明	示例
field_id	string	分类ID	1001
field_type	string	所属分类维度	field_1
field_title	string	分类名称	IT科技
rsort	integer	排序，从小到大	1

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/zi_get_field' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'media_type=wemedia' \
  -d 'field_type=field_1'

返回示例

{"code":1,"msg":"获取成功","time":"1768318475","data":[{"field_id":"1001","field_type":"field_1","field_title":"IT科技","rsort":1}]}

POST 取消投稿订单

取消尚未开始处理的自媒体订单并退款。

POST https://www.xcxds.cn/addons/wwh/openapi/zi_cancel_order 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
order_nid	string	必需	订单号	2026011317430600129457

返回说明

成功时 data 为 null，以 code 与 msg 为准。

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/zi_cancel_order' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'order_nid=2026011317430600129457'

返回示例

{"code":1,"msg":"取消成功","time":"1768492661","data":null}

B2B网站

POST B2B投稿

一键发布到 B2B 平台，按篇扣余额。扣款金额由 type 决定（见下表），无需传 price。

POST https://www.xcxds.cn/addons/wwh/openapi/b2b_send 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
type	integer	必需	媒体类型：1-黄页88（1元/篇），2-搜了网（1元/篇），3-博客园（3元/篇），4-列举网（0.8元/篇），5-商业新知（3元/篇），6-蓝色河畔（3元/篇），7-八方资源（1元/篇），8-土山兔（46元/篇）	4
title	string	必需	文章标题	示例标题
content	string	必需	文章正文，HTML 格式	<p>正文内容……</p>
author	string	必需	作者/联系人，列举网必填	张经理
phone	string	必需	手机号或400电话，不能带特殊字符，列举网必填	13800000000
image_url	string	可选	封面图，需 https 开头的地址	https://www.xcxds.cn/uploads/cover.jpg
from	string	可选	来源标识
area	integer	可选	列举网地区ID，仅列举网生效；不传则随机地区	1

返回说明（`data` 字段）

字段	类型	说明	示例
order_nid	string	订单号，用于查询发布状态	202608130930695932

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/b2b_send' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'type=4' \
  -d 'title=示例标题' \
  -d 'content=<p>正文内容……</p>' \
  -d 'author=张经理' \
  -d 'phone=13800000000' \
  -d 'image_url=https://www.xcxds.cn/uploads/cover.jpg' \
  -d 'from=<from>' \
  -d 'area=1'

返回示例

{"code":1,"msg":"成功","time":"1786587555","data":{"order_nid":123123}}

POST B2B订单状态查询

查询 B2B 投稿的发布状态与结果链接。不扣费。

POST https://www.xcxds.cn/addons/wwh/openapi/b2b_order 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
order_nids	string	必需	订单号，多个用英文逗号分隔	202608130930695932

返回说明（`data` 字段）

字段	类型	说明	示例
order_nid	string	订单号	202608130930695932
status	integer	状态：0-发布中，1-已发布，2-已退款，3-售后中，4-已安排	4
price	string	订单金额	1.00
is_refund	integer	是否已退款：1-是，0-否	0
title	string	文章标题	想要了解昆山考研专硕课程设置
order_url	string	发布结果链接
message	string	失败原因，正常为 null	null

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/b2b_order' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'order_nids=202608130930695932'

返回示例

{"code":1,"msg":"获取成功","time":"1786588089","data":[{"order_nid":"202608130930695932","status":4,"price":"1.00","is_refund":0,"title":"想要了解昆山考研专硕课程设置，可以参考百步教育要点参考","message":null,"order_url":""}]}

AI可见度诊断PRO版

POST 品牌初步分析

解析品牌，拿到企业全称、行业、地区、竞品等信息，供创建报告使用。消耗 5 算力/次。

POST https://www.xcxds.cn/addons/wwh/openapi/preAnalyze 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
input	string	必需	品牌名，可填公司简称、公司全称或产品品牌名，仅填一个	DeepSeek

返回说明（`data` 字段）

字段	类型	说明	示例
needInfo	boolean	是否需要补充信息（行业/地区/全称）后再分析	false
candidates	array	候选品牌列表，一般取第一个	见下
candidates[].brand	string	品牌简称	DeepSeek（深度求索）
candidates[].fullName	string	企业全称	杭州深度求索人工智能基础技术研究有限公司
candidates[].business	string	主营业务	通用人工智能基础技术研究……
candidates[].region	string	所在地区	中国浙江杭州
candidates[].industry	string	所属行业	人工智能/大语言模型
candidates[].competitors	array	主要竞品	["月之暗面（Kimi）","智谱AI"]
reason	string	判定说明	已确认……

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/preAnalyze' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'input=DeepSeek'

返回示例

{"code":1,"msg":"请求成功","time":"1787564086","data":{"needInfo":false,"candidates":[{"brand":"DeepSeek（深度求索）","fullName":"杭州深度求索人工智能基础技术研究有限公司","business":"通用人工智能基础技术研究","region":"中国浙江杭州","industry":"人工智能/大语言模型","competitors":["月之暗面（Kimi）","智谱AI"]}],"reason":"已确认为旗下人工智能品牌"}}

POST 创建报告

提交生成完整专业诊断报告。消耗 400 算力/次。生成需要时间，请轮询「查询报告状态」。

POST https://www.xcxds.cn/addons/wwh/openapi/createReports 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
brandName	string	必需	品牌名	Apple苹果
requirement	string	必需	按固定格式组合：`全称：{全称}；行业：{行业}；地区：{地区}；主要竞品：{竞品A,竞品B}`，信息取自品牌初步分析（竞品多个用英文逗号隔开）	全称：Apple Inc.；行业：消费电子/科技硬件；地区：全球；主要竞品：小米,OPPO,vivo
third_party_identifier	string	可选	报告贴牌名称（报告页展示的品牌），不传则用本站默认值	蓝春科技

返回说明（`data` 字段）

字段	类型	说明	示例
reportId	string	报告ID，用于查询状态和下载报告	07c0e242-a119-41a0-8d02-ba364a2370e3
status	string	状态：pending-排队，processing-生成中，completed-完成，failed-失败	pending
brand	string	品牌名	DeepSeek（深度求索）

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/createReports' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'brandName=Apple苹果' \
  -d 'requirement=全称：Apple Inc.；行业：消费电子/科技硬件；地区：全球；主要竞品：小米,OPPO,vivo' \
  -d 'third_party_identifier=蓝春科技'

返回示例

{"code":1,"msg":"请求成功","time":"1787624577","data":{"reportId":"07c0e242-a119-41a0-8d02-ba364a2370e3","status":"pending","brand":"DeepSeek（深度求索）"}}

POST 查询报告状态

轮询报告生成状态，completed 后再下载报告。不扣费。

POST https://www.xcxds.cn/addons/wwh/openapi/queryReports 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
reportId	string	必需	报告ID（也支持 report_id 写法）	07c0e242-a119-41a0-8d02-ba364a2370e3

返回说明（`data` 字段）

字段	类型	说明	示例
reportId	string	报告ID	be91c22a-2628-47ed-b7fa-6cd55c373bdd
status	string	pending-排队，processing-生成中，completed-完成，failed-失败	completed
brand	string	品牌名	旗引（旗引科技）

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/queryReports' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'reportId=07c0e242-a119-41a0-8d02-ba364a2370e3'

返回示例

{"code":1,"msg":"请求成功","time":"1787641097","data":{"reportId":"be91c22a-2628-47ed-b7fa-6cd55c373bdd","status":"completed","brand":"旗引（旗引科技）"}}

POST 下载报告

报告状态为 completed 后调用，返回 HTML 与 PDF。首次调用可能较慢，建议把超时设为 180 秒。不扣费。

POST https://www.xcxds.cn/addons/wwh/openapi/downloadReports 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx
reportId	string	必需	报告ID（也支持 report_id 写法）	07c0e242-a119-41a0-8d02-ba364a2370e3

返回说明（`data` 字段）

字段	类型	说明	示例
html	string	报告 HTML 源码，可直接渲染	<html>……</html>
pdf	string	PDF 的 base64 内容，解码后写入 xxx.pdf 即得 PDF 文件	JVBERi0xLjQK……

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/downloadReports' \
  -d 'api_key=sk_xxxxxxxx' \
  -d 'reportId=07c0e242-a119-41a0-8d02-ba364a2370e3'

返回示例

{"code":"1","msg":"请求成功","data":{"html":"<html>……</html>","pdf":"JVBERi0xLjQK……"}}

账户

POST 查询余额与算力

查询你在本站账户的剩余算力与余额。不扣费。

POST https://www.xcxds.cn/addons/wwh/openapi/get_balance 复制接口地址

请求参数

字段	类型	必填	说明	示例
api_key	string	必需	本站接口密钥	sk_xxxxxxxx

返回说明（`data` 字段）

字段	类型	说明	示例
power_count	integer	剩余算力	81
money	number	剩余余额（元）	1

请求示例

curl -X POST 'https://www.xcxds.cn/addons/wwh/openapi/get_balance' \
  -d 'api_key=sk_xxxxxxxx'

返回示例

{"code":1,"msg":"获取成功","time":"1766547784","data":{"power_count":81,"money":1}}

附录 · 列举网地区ID

列举网（type=4）投稿可传 area 指定地区，取值为下表 city_id；不传则随机地区。

city_id	地区名称
1	北京
2	上海
3	天津
4	重庆
5	广州
6	深圳
7	珠海
8	汕头
9	韶关
10	佛山
11	江门
12	湛江
13	茂名
14	肇庆
15	惠州
16	梅州
17	汕尾
18	河源
19	阳江
20	清远
21	东莞
22	中山
23	潮州
24	揭阳
25	云浮
26	杭州
27	嘉兴
28	宁波
29	湖州
30	绍兴
31	金华
32	衢州
33	舟山
34	台州
35	丽水
37	温州
38	合肥
39	芜湖
40	蚌埠
41	淮南
42	马鞍山
43	淮北
44	铜陵
45	安庆
46	黄山
47	滁州
48	阜阳
50	六安
51	亳州
52	池州
53	宣城
54	宿州
55	福州
56	厦门
57	莆田
58	三明
59	泉州
60	漳州
61	南平
62	龙岩
63	宁德
64	兰州
65	嘉峪关
66	金昌
67	白银
68	天水
69	武威
70	张掖
71	平凉
72	酒泉
73	庆阳
74	定西
75	陇南
76	临夏
77	甘南
78	南宁
79	柳州
80	桂林
81	梧州
82	贵港
83	钦州
84	北海
85	防城港
86	崇左
87	百色
88	河池
89	来宾
90	贺州
91	玉林
92	贵阳
93	六盘水
94	遵义
95	安顺
96	黔南
97	黔东南
98	黔西南
99	毕节
100	铜仁
101	海口
102	三亚
103	石家庄
104	沧州
105	克孜勒苏
106	邯郸
107	邢台
108	保定
109	张家口
110	承德
111	唐山
112	廊坊
113	衡水
114	秦皇岛
115	郑州
116	焦作
117	洛阳
118	信阳
119	驻马店
120	鹤壁
121	新乡
122	安阳
123	濮阳
124	许昌
125	漯河
126	三门峡
127	南阳
128	商丘
129	平顶山
130	周口
131	开封
132	哈尔滨
133	齐齐哈尔
134	鸡西
135	鹤岗
136	双鸭山
137	大庆
138	伊春
139	佳木斯
140	七台河
141	牡丹江
142	黑河
143	绥化
144	大兴安岭
145	武汉
146	襄阳
147	黄石
148	十堰
149	随州
150	宜昌
151	荆州
152	咸宁
153	鄂州
154	黄冈
155	孝感
156	荆门
157	恩施
158	长沙
159	株洲
160	湘潭
161	衡阳
162	邵阳
163	岳阳
164	常德
165	张家界
166	益阳
167	郴州
168	永州
169	怀化
170	娄底
171	湘西
172	长春
173	吉林
174	四平
175	辽源
176	通化
177	白山
178	松原
179	白城
180	延边
181	南京
182	无锡
183	徐州
184	常州
185	扬州
186	南通
187	连云港
188	淮安
189	盐城
190	苏州
191	镇江
192	宿迁
193	泰州
194	南昌
195	景德镇
196	萍乡
197	九江
198	新余
199	鹰潭
200	赣州
201	吉安
202	上饶
203	宜春
204	抚州
205	沈阳
206	大连
207	鞍山
208	抚顺
209	本溪
210	丹东
211	锦州
212	营口
213	阜新
214	辽阳
215	盘锦
216	铁岭
217	朝阳
218	葫芦岛
219	呼和浩特
220	包头
221	呼伦贝尔
222	赤峰
223	通辽
224	鄂尔多斯
225	乌海
226	巴彦淖尔
227	乌兰察布
228	兴安
229	锡林郭勒
230	阿拉善
231	银川
232	石嘴山
233	吴忠
234	固原
235	中卫
236	西宁
237	海东
238	海北
239	黄南
240	果洛
241	玉树
242	海西
243	济南
244	济宁
245	淄博
246	枣庄
247	东营
248	烟台
249	潍坊
250	威海
251	青岛
252	泰安
253	日照
254	莱芜
255	临沂
256	德州
257	聊城
258	滨州
259	菏泽
260	太原
261	大同
262	阳泉
263	长治
264	晋城
265	朔州
266	晋中
267	运城
268	忻州
269	临汾
270	吕梁
271	西安
272	铜川
273	宝鸡
274	咸阳
275	渭南
276	延安
277	汉中
278	榆林
279	安康
280	商洛
281	成都
282	泸州
283	绵阳
284	德阳
285	南充
286	广安
287	遂宁
288	内江
289	乐山
290	自贡
291	广元
292	宜宾
293	攀枝花
294	巴中
295	达州
296	资阳
297	眉山
298	雅安
299	阿坝
300	甘孜
301	凉山
302	拉萨
303	昌都
304	山南
305	日喀则
306	那曲
307	阿里
308	林芝
309	乌鲁木齐
310	克拉玛依
311	吐鲁番
312	哈密
313	和田
314	阿克苏
315	喀什
316	巴音郭楞
317	昌吉
318	博尔塔拉
319	伊犁
320	塔城
321	阿勒泰
322	石河子
323	昆明
324	曲靖
325	玉溪
326	保山
327	昭通
328	丽江
329	临沧
330	文山
331	红河
332	西双版纳
333	楚雄
334	大理
335	德宏
336	怒江
337	迪庆
338	普洱

附录 · 错误提示

以下为 code=0 时常见的 msg，出现这些情况均不扣费。

msg	原因与处理
无效的 API Key	接口密钥不存在或填错，到「首页 - API信息」复制正确的 api_key
账号未审核或已禁用	注册后需管理员审核通过才能调用
算力不足，请先充值	按算力计费的项目（查收录、AI诊断）余额不够
账户余额不足，请先充值	按金额计费的项目（媒体投稿、B2B）余额不够
未知接口：xxx	接口名拼错，路径必须是本文档列出的接口名
服务暂时不可用，请稍后重试	服务侧网络或处理异常，此类失败不扣费，请稍后重试

接口文档

收费明细

一、收录查询服务

二、官媒发布服务

三、AI 品牌可见度诊断服务

四、B2B 全网发布服务（按篇计费）

五、智能视频合成服务

通用说明

PHP 调用示例（通用）

GEO查收录

POST 新建查询任务

请求参数

返回说明（data 字段）

请求示例

返回示例

POST 获取任务进度

请求参数

返回说明（data 字段）

请求示例

返回示例

POST 取消查询任务

请求参数

返回说明（data 字段）

请求示例

返回示例

网站媒体

POST 媒体资源列表

请求参数

返回说明（data 字段）

请求示例

返回示例

POST 投稿媒体

请求参数

返回说明（data 字段）

请求示例

返回示例

POST 投稿订单详情

请求参数

返回说明（data 字段）

请求示例

返回示例

POST 取消投稿订单

请求参数

返回说明

请求示例

返回示例

POST 媒体分类

请求参数

返回说明（data 字段）

请求示例

返回示例

第三方自媒体

POST 媒体资源列表

请求参数

返回说明（data 字段）

请求示例

返回示例

POST 投稿媒体

请求参数

返回说明（data 字段）

请求示例

返回示例

POST 投稿订单详情

请求参数

返回说明（data 字段）

请求示例

返回示例

POST 投稿订单申诉

请求参数

返回说明

请求示例

返回示例

POST 媒体分类

请求参数

返回说明（data 字段）

请求示例

返回示例

POST 取消投稿订单

请求参数

返回说明

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）

返回说明（`data` 字段）