For AI

View as Markdown Open in ChatGPT Open in Claude

WeChat Search API

Also known as微信搜一搜搜一搜微信搜索weixin search

1 endpoint reads WeChat Search: posts. From $0.0200 a call. No WeChat Search login and no cookie; a failed call is free.

Start a free trial Try articles and videosUse it in Claude or Cursor: WeChat Search MCP →

Endpoints1 endpointone response shape

PriceFrom $0.0200per call. Failed calls are free

When an upstream failsRetried for youChecked every day with real calls · 4 days on record

DataFetched liveat the moment of the call

One call, as it came back

A recorded call, fields already tidied up: ready for an AI or a spreadsheet.

Recorded

GET/v1/wechat/posts/search$0.0200

FieldValue

typevideo

published_at2026-10-15 06:55 UTC

metrics.likes1

metrics.favorites3

The first 4 rows of a response recorded 2026-10-17 10:16 UTC.

Run it in the Playground · $0.0200

Recorded response

{
  "code": "ok",
  "request_id": "f99e115c-779f-40c2-8f31-aa264bce80dd",
  "data": {
    "items": [
      {
        "id": "1565947629032858",
        "url": null,
        "type": "video",
        "title": null,
        "text": "咖啡店开业｜第一次尝试就爱上了，清单放评论区",
        "published_at": "2026-10-15T06:55:50.000Z",
        "author": {
          "name": "橘子汽水不加冰",
          "avatar_url": "https://wx.qlogo.cn/mmhead/G9OFE9nvQizvdtoFhYPbPgJwNlPo1GOTzMZ7Yb1e/132"
        },
        "metrics": { "likes": 1, "favorites": 3 }
      },
      // … 19 more
    ]
  },
  "page": {
    "next_cursor": "c1.qgwIcUU3N03dRsj5WCHQWiriygBg_3bRP0gIll8U",
    "cursor_expires_at": "2026-10-17T11:16:20.000Z",
    "has_more": true,
    "returned": 20
  },
  "warnings": [],
  "meta": {
    "capability": "wechat.posts.search",
    "result_status": "complete",
    "fetched_at": "2026-10-17T10:16:20.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "lang": "capability",
      "author.id": "capability",
      "author.username": "capability",
      "author.verified": "capability",
      "author.followers": "capability",
      "metrics.comments": "capability",
      "metrics.shares": "capability",
      "metrics.views": "capability",
      "metrics.reposts": "capability",
      "images": "capability",
      "hashtags": "capability",
      "mentions": "capability",
      "is_pinned": "capability",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform"
    },
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    }
  }
}

From a response recorded 2026-10-17 10:16 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

What you can get

Each row is an endpoint: what it returns and what one call costs.

EndpointPathReturnsPrice

Posts1

WeChat Search articles and videosGET/v1/wechat/posts/searchPost list$0.0200

Prices are the prices in force. A call that fails, or whose result is uncertain, costs nothing.WeChat Search API pricing →WeChat Search data in your AI →See live status →

What people build with it

Ready-made tasks your AI can run on WeChat Search data. Each is a few calls under a spending cap.

Word of mouth and comment insight

Keyword search and mentions

“What is being said about this brand or keyword on each platform?”

WeChat Search articles and videos$0.0200

Example run: 3 calls, at most $0.0240

Ask about WeChat Search right inside Claude or Cursor

Add the DataXAPI MCP server and the AI finds the WeChat Search endpoint it needs and calls it; answers link back to the source. You pay for the calls it makes.

WeChat Search MCP setup →

https://api.dataxapi.com/mcp

Start in three steps

The call shown here is WeChat Search articles and videos. Every other WeChat Search endpoint is called the same way and answers in the same envelope.

Get a key

Call it, or let your AI call it

One GET from your code. Or paste this prompt into your agent with your key in it: it sets itself up, then finds and calls these endpoints by itself.

Read https://dataxapi.com/agents.md and set up DataXAPI in this agent. My API key is dx_live_…; use it for every DataXAPI call.

Read the same shape every time

Items are in data.items (one object in data.item), the next page in page.next_cursor, the charge in meta.billing.amount. A failed call is not charged.

Read the quickstart →

curl -G "https://api.dataxapi.com/v1/wechat/posts/search" \
  --data-urlencode "query=咖啡店开业" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.wechat.posts.search(query="咖啡店开业")
print(result["data"]["items"])

import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.wechat.posts.search({ query: "咖啡店开业" });
console.log(result.data.items);

dataxapi call wechat.posts.search 'query=咖啡店开业'

{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

Add this to your MCP client, then ask your agent to call wechat.posts.search.

Edge cases

What the WeChat Search endpoints do at their edges, and what to check when a call does not return what you expected.

Page sizes: A list returns 20 to 30 items a page, depending on the endpoint. Every list goes on to a next page: page.next_cursor, passed back as cursor, each page a call of its own.
Fields it cannot give: 1 of the 1 endpoints cannot fill every field of the object they return. Each endpoint's page lists which, and every answer repeats them in meta.unavailable: a missing field is never a silent zero.
Articles and videos in one page: A page holds Official Account articles and Channels videos in the order the search shows them; type says which each one is (article or video). An article has a link and a title; a video has neither.
IDs: An article's id is made from its link, the same as the Official Account article list gives; fetch the article by its url. A video's id is the encrypted one of the search result, as given: the Channels endpoints do not take it, and a later search may give the same video another.
Accounts by name only: A result names its Official Account or Channels account by name, never by ID. Articles come without counts; a video comes with the likes and saves its card shows.

Questions about the WeChat Search API

Short answers. The details are on each endpoint's page.

How is the WeChat Search API priced?

Per call, no subscription. The endpoint costs $0.0200 a call. You are charged when data comes back; a failed call costs nothing.

Do I need a WeChat Search account or a cookie?

No. One DataXAPI key is all you hold: no WeChat Search login, no cookie, no device to keep alive. The endpoints return publicly visible data only.

Is the data live?

A call fetches from WeChat Search at that moment, and meta.fetched_at says when. A result is kept for 24 hours, so a retry with the same Idempotency-Key is not charged again.

Is an empty result charged?

A list that comes back empty is charged its price: the search was run. Reading one object that does not exist answers not_found and is free.

What happens when WeChat Search changes something?

A call that fails is not charged, whatever the reason. An endpoint that is paused answers capability_paused, also free, and GET /v1/catalog/status says what is up right now.

Call WeChat Search with one key.

Free trial on sign-up: up to 5 calls at $0.0200. No card. No WeChat Search login, no cookie, no subscription. A failed call is free.

Start free