[中文]

用途:

传文章 URL，返回文章内嵌的广告位信息。该接口响应相对较慢，请耐心等待；未投放广告的文章返回空。

价格：0.01$/次

⏱️ 由于微信服务器原因，本接口响应较慢，请将客户端请求超时（timeout）设置为 30 秒；timeout 设置过小会造成已扣费但收不到响应的情况。

参数:

url: 公众号文章链接。示例 https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw（该文无广告，返回空）

raw: 可选，默认 True。True=完整原始响应；False=拍平后的广告列表。

文章广告位信息

响应结构与 JSON Path:

`raw=false`（精简投影）:

data 为拍平后的广告列表:

$.data.count: 广告条数（合并 advertisement_info 与 ad_slot_data）

$.data.ads[]: 广告项列表（无广告时为 []）

`raw=true`（原始）:

data 按抓到的响应聚合:

$.data.pages: 响应页数

$.data.results[]: 每页完整原始响应（广告原始字段在各页的 advertisement_info / ad_slot_data 内，即精简模式 ads 的来源）

[English]

Purpose:

Pass an article URL to get the embedded ad slot info of the article. This endpoint responds relatively slowly, please be patient; articles without ads return empty.

Price: $0.01 per request

⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.

Parameters:

url: WeChat MP article URL. E.g. https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw (this article has no ads, returns empty)

raw: Optional, default True. True=full raw response; False=flattened ad list.

Return:

Article ad slot info

Response structure & JSON Path:

`raw=false` (simplified projection):

data is the flattened ad list:

$.data.count: number of ads (merged from advertisement_info and ad_slot_data)

$.data.ads[]: ad item list ([] when no ads)

`raw=true` (raw):

data is aggregated by the responses captured:

$.data.pages: number of response pages

$.data.results[]: full raw response per page (raw ad fields are inside advertisement_info / ad_slot_data of each page — the source of ads in simplified mode)

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.tikhub.io/api/v1/wechat_mp/v2/fetch_article_ad' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "url": "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw", "raw": true }'

{ "code": 200, "request_id": "string", "message": "Request successful. This request will incur a charge.", "message_zh": "请求成功，本次请求将被计费。", "support": "Discord: https://discord.gg/aMEAS8Xsvz", "time": "string", "time_stamp": 0, "time_zone": "America/Los_Angeles", "docs": "string", "cache_message": "string", "cache_message_zh": "string", "cache_url": "string", "router": "", "params": {}, "data": null }

获取公众号文章广告/Get WeChat MP Article Ads

[中文]

用途:

参数:

返回:

响应结构与 JSON Path:

`raw=false`（精简投影）:

`raw=true`（原始）:

[English]

Purpose:

Parameters:

Return:

Response structure & JSON Path:

`raw=false` (simplified projection):

`raw=true` (raw):

Request

Responses

获取公众号文章广告/Get WeChat MP Article Ads

[中文]#

用途:#

参数:#

返回:#

响应结构与 JSON Path:#

raw=false（精简投影）:#

raw=true（原始）:#

[English]#

Purpose:#

Parameters:#

Return:#

Response structure & JSON Path:#

raw=false (simplified projection):#

raw=true (raw):#

Request

Responses

[中文]

用途:

参数:

返回:

响应结构与 JSON Path:

`raw=false`（精简投影）:

`raw=true`（原始）:

[English]

Purpose:

Parameters:

Return:

Response structure & JSON Path:

`raw=false` (simplified projection):

`raw=true` (raw):