# 微信搜一搜 API

1 个接口读微信搜一搜：帖子。一次 $0.0200 起。不用登录微信搜一搜，不用 Cookie；失败不收费。

也叫：WeChat Search、微信搜索

## 接口

### 帖子 (1)

| 接口 | 请求 | 返回 | 价格 |
| --- | --- | --- | --- |
| [微信搜一搜综合搜索](https://dataxapi.com/zh/apis/wechat/posts/search.md) | `GET /v1/wechat/posts/search` | 内容列表 | $0.0200 / 次 |

## 调用前要知道的

- **每页条数**：列表每页 20 到 30 条，各接口不同。每个列表都能翻页：把 `page.next_cursor` 作为 `cursor` 传回，每一页是一次单独的调用。
- **给不了的字段**：1 个接口里有 1 个填不满它返回的对象。每个接口的页面列出了给不了哪些，每次返回也在 `meta.unavailable` 里再写一遍：缺的字段不会被悄悄写成 0。

## 调用结果不对时先看这里

- **文章和视频混在一页**：一页里公众号文章和视频号视频按搜索页的顺序混在一起，每条用 `type` 标明是文章（`article`）还是视频（`video`）。文章有链接和标题，视频两样都没有。
- **编号**：文章的 `id` 由文章链接拼成，和公众号文章列表给的一样，取文章用它的 `url`。视频的 `id` 是搜索结果里的加密编号，原样照给：视频号的接口不收它，以后再搜同一条视频也可能是另一个编号。
- **账号只有名称**：每条结果只给公众号或视频号的名称，不给账号编号。文章不带互动数；视频带卡片上显示的点赞和收藏数。

## 常见问题

### 微信搜一搜 API 怎么收费？

按次收费，没有订阅。这个接口一次 $0.0200。拿到数据才扣费，失败不收。

### 需要微信搜一搜账号或 Cookie 吗？

不需要。你只拿一把 DataXAPI 的 Key：不用登录微信搜一搜，不用 Cookie，也不用养设备。接口只返回公开可见的数据。

### 数据是实时的吗？

每次调用都当场去微信搜一搜取，`meta.fetched_at` 写明取到的时间。结果保留 24 小时，带同一个 `Idempotency-Key` 重试不会再扣一次。

### 空结果收费吗？

列表返回空结果时照价收费：搜索已经执行了。读单个对象而对象不存在时返回 `not_found`，不收费。

### 微信搜一搜改版了怎么办？

调用失败不管什么原因都不扣费。被暂停的接口返回 `capability_paused`，同样不扣费；`GET /v1/catalog/status` 写着现在哪些能用。

## 怎么做和常见问题

- [如何获取公众号历史文章列表](https://dataxapi.com/zh/guides/wechat-official-account-articles.md)
- [如何获取公众号文章阅读数和点赞数](https://dataxapi.com/zh/guides/wechat-article-reads-and-likes.md)
- [如何获取视频号视频评论](https://dataxapi.com/zh/guides/wechat-channels-video-comments.md)
- [公众号文章能用 API 读取吗？](https://dataxapi.com/zh/answers/is-there-an-api-for-wechat-official-account-articles.md)
- [视频号数据怎么获取？](https://dataxapi.com/zh/answers/how-to-get-wechat-channels-data.md)

---

怎么调用、怎么计费、怎么处理报错，所有接口都一样：https://dataxapi.com/zh/llms.txt

最后核对于 2026-10-21 10:10 UTC。目录修订号 c48ce454ae6c4c65。 [网页版](https://dataxapi.com/zh/apis/wechat/)
