Skip to main content

Social Media API

WeChat API

Read WeChat across three surfaces — 搜一搜 universal search, Official Account (公众号) articles with stats and comments, and Channels (视频号) video with parse/download — as structured JSON.

  • 搜一搜 universal search across 公众号 and 视频号 in one call
  • 公众号 article content with interaction stats, comments, and related articles
  • 视频号 video parse/download, collections, live history, and in-channel search

$0.05 free credit on sign-up · no credit card · from $0.001/request

One request, structured JSON

terminal
1curl -X GET "https://api.tikhub.io/api/v1/wechat_mp/v2/fetch_article_detail?url=https://mp.weixin.qq.com/s/EXAMPLE" \
2 -H "Authorization: Bearer YOUR_API_KEY"
response.json
1{
2 "code": 200,
3 "data": {
4 "title": "示例公众号文章标题",
5 "author": "公众号名称",
6 "publish_time": 1717200000,
7 "read_num": 84000,
8 "like_num": 3200,
9 "comment_count": 410,
10 "content_html": "<section>...</section>"
11 }
12}

Get your API key at user.tikhub.io/dashboard/api — or follow the getting-started guide.

FastPay-as-you-goScales to millions99.9% uptimeWell-documentedNo app review

What's in the WeChat API

TikHub's WeChat API opens three surfaces of 微信 through the new V2 routes: 搜一搜 universal search across both 公众号 and 视频号 in one call; Official Account (公众号) articles — the long-form publishing layer of the Chinese internet — with full content, interaction stats, and comments; and 视频号 (Channels) short video with profiles, collections, live, and parse/download.

WeChat Search V2 (搜一搜, recommended)

Universal 搜一搜 searchAcross 公众号 + 视频号One-call comprehensive search

WeChat Media Platform V2 (公众号)

Account profileAccount articlesServices & custom menuArticle detail & statsComments & repliesRelated articlesArticle ads

WeChat Channels V2 (视频号)

Channel & user profile + statsUser videos & collectionsVideo detail (parse / download)Video comments & share URLLive history & detailIn-channel searchID → finder username

Major update: the old /api/v1/wechat_channels/* and /api/v1/wechat_mp/web/* series were fully deprecated on June 13, 2026. Use the new V2 routes — wechat_search/v2, wechat_mp/v2, and wechat_channels/v2.

公众号 articles and read counts — a closed surface, opened

WeChat is the most closed major platform in China, and Official Account (公众号) articles are where its long-form thought leadership and industry analysis live. TikHub returns full article content (JSON or HTML), read counts as an attention signal, comment threads, and — uniquely — search across accounts and articles. Little of this is accessible anywhere else.

TikHubGeneric scrapers
公众号 article full content (JSON/HTML)
Article read counts
Official-account & article search
WeChat Channels video data

WeChat API endpoints

A reference of the most-used WeChat endpoints. Browse the full set in the API reference or the documentation.

WeChat Search V2 (搜一搜 — recommended)

Comprehensive 搜一搜 universal search across BOTH Official Accounts (公众号) and Channels (视频号) in one call. Note: WeChat search does not paginate — send the same request again for more results (some may repeat).

Use caseEndpointDocs
WeChat universal search (搜一搜)/api/v1/wechat_search/v2/fetch_search

WeChat Media Platform V2 (公众号)

Replaces the deprecated /api/v1/wechat_mp/web/* series. Account profiles and articles, article detail with interaction stats, comments and replies, related articles, and article ads.

Use caseEndpointDocs
Get account profile (公众号资料页)/api/v1/wechat_mp/v2/fetch_account_profile
Get account articles (文章列表)/api/v1/wechat_mp/v2/fetch_account_articles
Get account services & custom menu/api/v1/wechat_mp/v2/fetch_account_services
Get article detail (文章详情)/api/v1/wechat_mp/v2/fetch_article_detail

WeChat Channels V2 (视频号)

Replaces the deprecated /api/v1/wechat_channels/* series. Channel/user profiles and stats, videos and collections, live history/detail, in-channel search, and video detail (parse/download) with a decode_key — see the tips for the decryption flow.

Use caseEndpointDocs
Get channel account info (账号信息)/api/v1/wechat_channels/v2/fetch_channel_info
Channel ID → finder username/api/v1/wechat_channels/v2/fetch_channel_id_to_username
Get user profile & stats (主页资料+统计)/api/v1/wechat_channels/v2/fetch_user_profile
Get user videos (作品列表)/api/v1/wechat_channels/v2/fetch_user_videos

Tips & troubleshooting

Hard-won operational notes for working with WeChat data in production.

The old WeChat series are fully deprecated — migrate to V2

On June 13, 2026 the legacy /api/v1/wechat_channels/* and /api/v1/wechat_mp/web/* series were retired. Move 公众号 calls to /api/v1/wechat_mp/v2/* (e.g. fetch_mp_article_detail_json/html → fetch_article_detail; fetch_mp_article_read_count → fetch_article_stats; fetch_search_* → the unified 搜一搜 endpoint), and 视频号 calls to /api/v1/wechat_channels/v2/*. The V2 routes use a clean version-numbered naming convention.

视频号 video parsing & decryption (V2)

fetch_video_detail returns the video's media address plus a decode_key. Provide at least one input, in priority order object_id > export_id > share_url: object_id (numeric) comes from fetch_user_videos / fetch_collection_videos; export_id comes from search results (starts with export/, expires quickly — pair it with object_nonce_id / feedNonceId to improve hit rate); share_url is a weixin.qq.com/sph/… link used only when the others are empty. Set raw=false for a simplified, download-ready structure. The bare url may not open (anti-hotlinking) — use full_url (= url + url_token). If the MP4 won't play it's encrypted: decrypt with the decode_key from the SAME response — every request returns a new link + key pair.

snippet
1// fetch_video_detail (V2), raw=false → $.data.media is one object
2const m = data.media;
3const fullUrl = m.full_url; // = m.url + m.url_token (anti-hotlinking)
4const key = m.decode_key; // decrypt the MP4 with this
5// each request returns a NEW link + decode_key — use a matching pair from ONE response
6// raw=true instead → $.data.objects[0].objectDesc.media[0].{url, urlToken, decodeKey}

WeChat Channels video decryption tool

Set a 30-second request timeout

WeChat servers are slow, so set your client request timeout to about 30s — too small a timeout can bill you for the request without returning a response. Play and download counts (播放量/下载量) are not available because WeChat does not expose them publicly.

搜一搜 universal search — one call, no pagination

The 搜一搜 endpoint (wechat_search/v2/fetch_search) searches BOTH 公众号 and 视频号 in a single call — the recommended starting point for discovery. WeChat search does not paginate: to get more results, send the same request again (some results may repeat). Search runs on limited backend resources, so a first attempt can return partial results — retry a few times if needed.

Read count & article stats are the 公众号 signal

On WeChat Official Accounts, an article's read count (阅读数) is the key metric — it reflects how many people actually opened the piece inside a closed messaging app, a stronger attention signal than a public like count. fetch_article_stats (文章互动数据) returns the interaction data, and fetch_article_detail returns full article content for parsing, AI, and archiving.

Do I need a WeChat developer account?

No. Create a free TikHub account, generate an API key, and call REST endpoints directly — no WeChat developer application, app review, or OAuth.

What WeChat data can I extract?

搜一搜 universal search across 公众号 and 视频号; Official Account (公众号) article content, interaction stats, comments, related articles, and ads; and Channels (视频号) profiles, videos, collections, live history, comments, and video parse/download.

How much does the WeChat API cost?

Pay-as-you-go from $0.001 per request, with automatic daily volume discounts down to $0.0005 at 30,000+ requests/day. New accounts get $0.05 free credit (~50 requests) — no credit card required.

Is using a WeChat API like this legal?

TikHub only returns publicly available WeChat data — content any visitor can see without an account. It does not bypass authentication or access private information. WeChat is a Chinese platform, so the relevant constraints are its own Terms of Service and China's data and cross-border rules rather than US case law; automated access can lead to account or IP blocks, which TikHub's infrastructure absorbs for you. You remain responsible for how you store, process, and use the data — especially any personal data and any onward transfer across borders.

WeChat API: read Official Account (公众号) articles in 2026

TikHub's WeChat API reads public 微信 Official Account (公众号) data — article content, read counts, comments, and search — plus WeChat Channels video, through plain REST calls. Here's how it works, why it opens a closed platform, and which option fits which job.

How does the WeChat API work?

What is the WeChat API?

The TikHub WeChat API is a RESTful interface that returns structured JSON (or HTML) for public content on 微信 — primarily Official Account (公众号) articles, the long-form publishing layer where Chinese industry analysis and thought leadership live, plus WeChat Channels short video. You request an article, its read count, comments, related articles, or a search and get clean data back.

What makes it notable is access itself: WeChat is the most closed major platform in China, so structured article content, read counts, and cross-account search are hard to obtain anywhere else.

How do you access and use it?

Create a TikHub account, generate an API key, and make an HTTP GET request with the key in the Authorization header. Pass an article URL to the detail endpoint (JSON or HTML), or search for accounts and articles to discover content. A common flow is to search an industry term, list an account's articles, then pull each article's content and read count for analysis.

What are the benefits of using the WeChat API?

Why is WeChat data hard to get and worth getting?

WeChat lives behind an app with no public web surface to speak of, strong anti-automation, and content distributed through private channels — which is exactly why programmatic access is rare and valuable. 公众号 articles are where serious Chinese industry analysis is published, and read counts reveal what genuinely commands attention. TikHub makes that readable as structured data without you fighting the platform.

Who benefits, and what do they save?

Analysts and researchers monitoring Chinese industry discourse, brands tracking their own and competitors' narratives, and AI teams building long-form Chinese training corpora. The saving is access: rather than manually following accounts inside the app, you get a searchable, structured feed of the content and its attention metrics.

What are common use cases and alternatives?

What are the common use cases?

公众号 thought-leadership and industry monitoring, brand-narrative tracking, read-count attention analysis, and long-form Chinese content archiving. AI teams use article text for retrieval pipelines, summarization, and knowledge extraction — 公众号 articles are among the highest-quality long-form Chinese sources available.

What are the alternatives, and which is best?

There's no meaningful official API for reading arbitrary public 公众号 content, and scraping WeChat directly is notoriously difficult. A handful of niche tools exist but rarely combine content, read counts, and search. For reliable access to all three without building against a closed app, a managed API like TikHub is effectively the practical option — one key, also covering Zhihu, Weibo, and the rest of the Chinese platforms.

One key, every platform

The WeChat API shares its key and JSON format with 15 other platforms — adding Instagram or Douyin is a one-line change.

Start free