# 微信公众号搜索 API

微信公众号搜索接口（search）：每次成功调用 1.5 credits，支持 HTTP 与 Remote MCP，输入、数据来源和计费规则清晰。

规范地址: https://socialtoai.com/zh/wechat-search-api/

## 一次请求

成功或空结果每次 1.5 credits，失败不计费。

把 PASTE_PUBLIC 占位符换成受支持的公开标识。这是请求模板，不会自动执行。

```
curl --request POST 'https://api.socialtoai.com/v1/search' \
  --header "X-API-Key: $SOCIALTOAI_API_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: REPLACE_WITH_A_UNIQUE_REQUEST_ID' \
  --data '{"platform":"wechat","query":"AI research","count":5}'
```

## 原生支持

结果类型：item or profile_card (type=user)。翻页：使用返回的不透明 cursor。

sort：relevance, latest, most_liked。

time_range：1d, 7d, all。

content_type：all, text。

type：content, user。

以上取值来自参考卡。用户查找或特定内容类型可能还有额外限制。请以响应里的 applied_params 和 warnings 为准，不要假定不支持的筛选已生效。

## 经过结构校验的示例

示意结果，只含一条虚构数据和示例试用余额，用来展示响应结构，不是实时结果，也不代表线上可用率。

```
{
  "request_id": "example_only_not_a_live_call",
  "schema_version": "v1",
  "fetched_at": "2026-09-05T00:00:00Z",
  "status": "ok",
  "applied_params": {},
  "warnings": [],
  "items": [
    {
      "kind": "item",
      "id": "EXAMPLE_ITEM_ID",
      "author": {
        "name": "example_author"
      },
      "published_at": "2026-09-01T08:30:00Z",
      "metrics": {
        "likes": 412,
        "comments": 96
      },
      "title": "Illustrative post title",
      "text": "Illustrative excerpt, not real content."
    }
  ],
  "platform": "wechat",
  "billing": {
    "cost": 1.5,
    "balance": 0.5,
    "unit": "credits",
    "pricing": "standard"
  }
}
```

## 平台限制

不支持热榜。可以用 sort=latest 的搜索替代，但含义不同。

详情和评论需要 HTTPS 的 mp.weixin.qq.com 文章链接，不能只传 ID。

公众号资料和文章列表需要 gh_username。可先用 search(type=user) 查找账号，查找本身是一次单独计费的调用。

搜索的 30d 筛选会回退为 all 并附带 warning。count 只裁剪投影后的结果，不改变源页面大小。

[微信公众号全部接口 →](https://socialtoai.com/zh/platforms/wechat/)