EveryData platform API
WeChat Official Accounts API
WeChat Official Accounts data here means WeChat Official Account articles, accounts, Mini Programs, comments, engagement, and WeChat Index results, divided among 12 WeChat Official Accounts actions with explicit WeChat Official Accounts target objects: `article_search`, `account_search`, `mini_program_search`.
Use `article_search` to search for articles, or `account_search` to search for official account profiles. Both actions accept `keyword` as the primary search parameter.
- Endpoint
- POST /api/v1/social
- Capabilities
- 12
- Per 1,000
- $5.556
Available capabilities
Compare the WeChat Official Accounts actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
article_searchArticle search Search WeChat Official Accounts with the | keyword | category, sub_type | Sync delivery | Catalog value: maxLimit=20. Check the action notes before treating it as a final row count. | $5.56 per 1,000 requests | id · title · summary · url · cover_image_url · account_name · posted_at · relative_time · kind · platform |
account_searchAccount search Search WeChat Official Accounts with the | keyword | — | Sync delivery | Catalog value: maxLimit=20. Check the action notes before treating it as a final row count. | $5.56 per 1,000 requests | account_id · ghid · name · description · alias · avatar_url · verify_flag · biz · platform |
mini_program_searchMini Program search Search WeChat Official Accounts with the | keyword | — | Sync delivery | Catalog value: maxLimit=20. Check the action notes before treating it as a final row count. | $5.56 per 1,000 requests | id · name · description · icon_url · username · is_minigame · platform |
search_suggestionsSearch suggestions Search WeChat Official Accounts with the | keyword | — | Sync delivery | — | $5.56 per 1,000 requests | suggestions · count · platform |
account_profileAccount details Use the | account | — | Sync delivery | — | $5.56 per 1,000 requests | account_id · name · account_type · description · avatar_url · biz · platform |
account_principalAccount owner Use the | account | — | Sync delivery | — | $5.56 per 1,000 requests | account_id · ghid · name · description · company_name · owner_name · customer_type · verify_status · verify_type · verified_at · registered_country · registered_at · is_overseas · last_login_province · authorized_agents · platform |
account_articlesAccount articles Use the | account | — | Sync delivery | Catalog value: maxLimit=20. Check the action notes before treating it as a final row count. | $5.56 per 1,000 requests | id · title · url · cover_image_url · posted_at · position · is_original · is_deleted · account_name · account_id · account_ghid · platform |
account_today_articlesToday's account articles Use the | account | — | Sync delivery | — | $5.56 per 1,000 requests | id · title · url · cover_image_url · posted_at · position · is_original · is_deleted · account_name · account_id · account_ghid · platform |
article_commentsArticle comments Retrieve article comments from WeChat Official Accounts. Accepts these parameters: | url | — | Sync delivery | Catalog value: maxLimit=20. Check the action notes before treating it as a final row count. | $5.56 per 1,000 requests | id · text · author_name · author_avatar_url · like_count · posted_at · is_top · reply_count · country · province · platform |
comment_repliesComment replies Retrieve comment replies from WeChat Official Accounts. Accepts these parameters: | url, comment_id | content_id | Sync delivery | — | $5.56 per 1,000 requests | id · text · author_name · author_avatar_url · like_count · posted_at · country · province · city · platform |
article_metricsArticle engagement Use the | url | — | Sync delivery | — | $5.56 per 1,000 requests | read_count · like_count · watching_count · share_count · collect_count · comment_count · platform |
wechat_indexWeChat Index Use the | keyword | — | Sync delivery | — | $5.56 per 1,000 requests | keyword · latest_index · latest_date · data_points · trend · platform · index · date |
What does each WeChat Official Accounts action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the WeChat Official Accounts article_search parameters mean?
Search WeChat Official Accounts with the article_search action. Accepts these parameters: sub_type, keyword, and category. Returns these fields: cover_image_url, title, account_name, and summary.
keywordRequired- Specifies the search term across WeChat Official Account actions, including searching articles (article_search), accounts (account_search), mini programs (mini_program_search), search auto-suggestions (search_suggestions), and trend indices (wechat_index). It does not search personal WeChat chats.
categoryOptional- Filters articles by category in the article_search action. Allowed values are ALL, LATEST, HOT, FOLLOWED, and RECENT_READ. Note that FOLLOWED and RECENT_READ depend on account state; because your personal WeChat login session is not passed, these options are not guaranteed to work and will not read your personal subscription or reading history.
sub_typeOptional- A compatibility alias for category in article_search that accepts the same five category values (automatically converted to uppercase). If both category and sub_type are provided, category takes precedence.
What do the WeChat Official Accounts account_search parameters mean?
Search WeChat Official Accounts with the account_search action. Accepts these parameters: keyword. Returns these fields: name, biz, verify_flag, and ghid.
keywordRequired- Specifies the search term across WeChat Official Account actions, including searching articles (article_search), accounts (account_search), mini programs (mini_program_search), search auto-suggestions (search_suggestions), and trend indices (wechat_index). It does not search personal WeChat chats.WeChat: Official Account Nickname, WeChat ID, and Original IDWeChat documentation defines nick_name, alias, and user_name as the nickname, user-configured WeChat ID, and original ID respectively, where alias may be empty. In search results on this page, name, account_id, and ghid must be verified individually and not treated as identical strings.Checked
What do the WeChat Official Accounts mini_program_search parameters mean?
Search WeChat Official Accounts with the mini_program_search action. Accepts these parameters: keyword. Returns these fields: name, icon_url, is_minigame, and username.
keywordRequired- Specifies the search term across WeChat Official Account actions, including searching articles (article_search), accounts (account_search), mini programs (mini_program_search), search auto-suggestions (search_suggestions), and trend indices (wechat_index). It does not search personal WeChat chats.
What do the WeChat Official Accounts search_suggestions parameters mean?
Search WeChat Official Accounts with the search_suggestions action. Accepts these parameters: keyword. Returns these fields: suggestions and count.
keywordRequired- Specifies the search term across WeChat Official Account actions, including searching articles (article_search), accounts (account_search), mini programs (mini_program_search), search auto-suggestions (search_suggestions), and trend indices (wechat_index). It does not search personal WeChat chats.
What do the WeChat Official Accounts account_profile parameters mean?
Use the account_profile action on WeChat Official Accounts. Accepts these parameters: account. Returns these fields: name, avatar_url, description, and account_type.
accountRequired- Identifies the target WeChat Official Account using its WeChat ID, raw ID (starting with gh_), or a resolvable account/article URL. It does not accept personal WeChat IDs. Used by account_principal (for publisher profile metadata), account_articles (for historical post lists), and account_today_articles (for posts published today).WeChat: Account Type, Verification Type, and Principal Entity NameOfficial WeChat documentation separately details account types, verification types, and principal entity names; account display names are distinct from principal entity names. This reference only aligns terminology, does not imply official account management authorization, and does not copy WeChat access_token or appid values into parameters for this API.Checked
What do the WeChat Official Accounts account_principal parameters mean?
Use the account_principal action on WeChat Official Accounts. Accepts these parameters: account. Returns these fields: ghid, verified_at, description, and authorized_agents.
accountRequired- Identifies the target WeChat Official Account using its WeChat ID, raw ID (starting with gh_), or a resolvable account/article URL. It does not accept personal WeChat IDs. Used by account_principal (for publisher profile metadata), account_articles (for historical post lists), and account_today_articles (for posts published today).WeChat: Account Type, Verification Type, and Principal Entity NameOfficial WeChat documentation separately details account types, verification types, and principal entity names; account display names are distinct from principal entity names. This reference only aligns terminology, does not imply official account management authorization, and does not copy WeChat access_token or appid values into parameters for this API.Checked
What do the WeChat Official Accounts account_articles parameters mean?
Use the account_articles action on WeChat Official Accounts. Accepts these parameters: account. Returns these fields: posted_at, is_original, account_ghid, and cover_image_url.
accountRequired- Identifies the target WeChat Official Account using its WeChat ID, raw ID (starting with gh_), or a resolvable account/article URL. It does not accept personal WeChat IDs. Used by account_principal (for publisher profile metadata), account_articles (for historical post lists), and account_today_articles (for posts published today).
What do the WeChat Official Accounts account_today_articles parameters mean?
Use the account_today_articles action on WeChat Official Accounts. Accepts these parameters: account. Returns these fields: account_ghid, account_id, account_name, and is_original.
accountRequired- Identifies the target WeChat Official Account using its WeChat ID, raw ID (starting with gh_), or a resolvable account/article URL. It does not accept personal WeChat IDs. Used by account_principal (for publisher profile metadata), account_articles (for historical post lists), and account_today_articles (for posts published today).
What do the WeChat Official Accounts article_comments parameters mean?
Retrieve article comments from WeChat Official Accounts. Accepts these parameters: url. Returns these fields: reply_count, author_avatar_url, province, and posted_at.
urlRequired- Specifies the mp.weixin.qq.com article URL for article_comments, comment_replies, and article_metrics. Account-level actions accept this parameter only as a lowest-priority fallback input for resolving the target account.WeChat Official Accounts: Distinction Between Article Comments and Featured CommentsWeChat comment documentation distinguishes among articles, comment IDs, featured flags, and reply details. The comment scope visible in the backend of official authorized interfaces is not identical to the visibility scope of this endpoint, and `is_top` cannot be directly treated as the official comment_type featured flag.Checked
What do the WeChat Official Accounts comment_replies parameters mean?
Retrieve comment replies from WeChat Official Accounts. Accepts these parameters: url, comment_id, and content_id. Returns these fields: author_name, city, text, and province.
urlRequired- Specifies the mp.weixin.qq.com article URL for article_comments, comment_replies, and article_metrics. Account-level actions accept this parameter only as a lowest-priority fallback input for resolving the target account.
comment_idRequired- Specifies the target comment ID for comment_replies. Obtain this value from the article_comments response for the same article. Must be paired with the corresponding article URL; this is not an article ID.WeChat Official Accounts: Existing Replies and Comment Management OperationsWeChat lists viewing comments, posting replies, deleting replies, and managing featured comments as separate operations. The `comment_replies` endpoint here reads existing replies only and does not grant capabilities to post, delete, or manage comments simply because its name includes replies.Checked
content_idOptional- A compatibility alias for comment_id in the comment_replies action. It takes lower precedence than comment_id when both are provided.
What do the WeChat Official Accounts article_metrics parameters mean?
Use the article_metrics action on WeChat Official Accounts. Accepts these parameters: url. Returns these fields: read_count, like_count, collect_count, and comment_count.
urlRequired- Specifies the mp.weixin.qq.com article URL for article_comments, comment_replies, and article_metrics. Account-level actions accept this parameter only as a lowest-priority fallback input for resolving the target account.
What do the WeChat Official Accounts wechat_index parameters mean?
Use the wechat_index action on WeChat Official Accounts. Accepts these parameters: keyword. Returns these fields: keyword, latest_date, index, and trend.
keywordRequired- Specifies the search term across WeChat Official Account actions, including searching articles (article_search), accounts (account_search), mini programs (mini_program_search), search auto-suggestions (search_suggestions), and trend indices (wechat_index). It does not search personal WeChat chats.
How to use the WeChat Official Accounts API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"wechat_oa","action":"article_search","params":{"keyword":"<keyword>"}}'
WeChat Official Accounts API questions
What can I retrieve with the WeChat Official Accounts API?
Set platform to wechat_oa. The current catalog lists article search, account search, Mini Program search, search suggestions, account details, and more. These action names identify different WeChat Official Accounts objects or views; they are not interchangeable search modes.
Which input starts a WeChat Official Accounts `article_search` request?
Specifies the search term across WeChat Official Account actions, including searching articles (article_search), accounts (account_search), mini programs (mini_program_search), search auto-suggestions (search_suggestions), and trend indices (wechat_index). It does not search personal WeChat chats. Send it as keyword inside params.
Which fields can WeChat Official Accounts `article_search` return?
Its declared schema includes title, summary, cover_image_url, and account_name. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every WeChat Official Accounts action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.