Start building

WeChat MP Account Profile

https://api.sandbase.ai/v1/api/wechat-mp/v2/account-profile

Retrieves the profile details of an official WeChat account, including name, avatar, signature, and verification entity type using its official account ID.

Try this APIGet API key
Price
$0.01USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
1 required · 1 optional
Production route

Try the model

Playground

Open playground
Input
Optional, default True. True=raw; False=simplified parsing.
Official account `gh_username` (`gh_…`). Sources: `content.user_name` from article detail, or `jumpInfo.userName` from WeChat Search V2 `fetch_search` (business_type=account) results. E.g. `gh_363b924965e9`
OutputExample
Responseoutputs · 209.6 KB · 4,238 lines
[
  {
    "data": {
      "accountInfo": {
        "banReason": "",
        "banType": 0,
        "pbRequestMsgInfo": null,
        "serviceType": 0,
        "userName": "gh_363b924965e9",
        "userRole": 0
      },
      "aiChatInfo": {
        "aiChatOpen": 2,
        "extInfo": "",
        "pbRequestMsgInfo": null,
        "pollInterval": 180,
        "reportExtInfo": "",
        "roomInfo": "",
        "stringBizuin": "MjM5MjAxNDM4MA=="
      },
      "aiIvrReplyInfo": {
        "aiReplyOpen": 0,
        "pbRequestMsgInfo": null,
        "wording": ""
      },
      "articleTab": {
        "msgList": {
          "featuredList": [],
          "featuredUpdateTime": 1790688730,
          "hideList": false,
          "msg": [
            {
              "appMsg": {
                "baseInfo": {
                  "appMsgId": 2667036897,
                  "bigPic": 1,
                  "createTime": 1790687968,
                  "hasExpanded": false,
                  "pbRequestMsgInfo": null,
                  "type": 9,
                  "updateTime": 1790688728
                },
                "detailInfo": [
                  {
                    "appEditJumpUrl": "",
                    "audioDuRation": 0,
                    "audioId": 0,
                    "audioPlayUrl": "",
                    "authorDesc": "",
                    "canModifyByWxa": 0,
                    "contentUrl": "http://mp.weixin.qq.com/s?__biz=MjM5MjAxNDM4MA==&mid=2667036897&idx=1&sn=114b0005f5d6c47e4aa1b1d431980ba1&chksm=bc0407858361d0de681a8c1613f58cdabb2e76f52257d4ce23f0470a669df8f62d68c79228ff&scene=126&sessionid=0#rd",
                    "coverImgUrl": "https://mmbiz.qpic.cn/mmbiz_jpg/QaRWjMxooXsJHOMd8MXUs8ruLTCBeRx0sqmwfMJMbzuQb3e7hzfeHeusfF4iamvCEVTWk0DN09dSnpzicibYJIUTkaXqpZTgXO6rdGOvcLo65A/640?wxtype=jpeg&wxfrom=25",
                    "coverImgUrl11": "https://mmbiz.qpic.cn/mmbiz_jpg/QaRWjMxooXv9aCvIvx5OhEXmiaXTY8oNbWmqfZ2xBcVbCeKBt9D1a04MSrnRqFaUUdOqJeUyex0kNdicf805xEibWQ6bO0a1pUyHD5tlKZAhfk/300?wxtype=jpeg&wxfrom=25",
                    "coverImgUrl169": "https://mmbiz.qpic.cn/mmbiz_jpg/QaRWjMxooXsJHOMd8MXUs8ruLTCBeRx0sqmwfMJMbzuQb3e7hzfeHeusfF4iamvCEVTWk0DN09dSnpzicibYJIUTkaXqpZTgXO6rdGOvcLo65A/640?wxtype=jpeg&wxfrom=25",
                    "coverImgUrl169640": "https://mmbiz.qpic.cn/mmbiz_jpg/QaRWjMxooXsJHOMd8MXUs8ruLTCBeRx0sqmwfMJMbzuQb3e7hzfeHeusfF4iamvCEVTWk0DN09dSnpzicibYJIUTkaXqpZTgXO6rdGOvcLo65A/640?wxtype=jpeg&wxfrom=25",
                    "coverImgUrl2351": "https://mmbiz.qpic.cn/mmbiz_jpg/QaRWjMxooXsJHOMd8MXUs8ruLTCBeRx0sqmwfMJMbzuQb3e7hzfeHeusfF4iamvCEVTWk0DN09dSnpzicibYJIUTkaXqpZTgXO6rdGOvcLo65A/640?wxtype=jpeg&wxfrom=25",
                    "coverimgurl34": "https://mmbiz.qpic.cn/mmbiz_jpg/QaRWjMxooXsJHOMd8MXUs8ruLTCBeRx0sqmwfMJMbzuQb3e7hzfeHeusfF4iamvCEVTWk0DN09dSnpzicibYJIUTkaXqpZTgXO6rdGOvcLo65A/540?wxtype=jpeg&wxfrom=25",
                    "createTime": 0,
                    "digest": "",
                    "featuredInfo": {
                      "appMsgId": 0,
                      "featured": 0,
                      "itemIndex": 0,
                      "pbRequestMsgInfo": null,
                      "status": 0
                    },
                    "finderFeedXml": "",
                    "finderLive": null,
                    "isModified": 0,
                    "isPaid": 0,
                    "isPaySubscribe": 0,
                    "itemIndex": 1,
                    "itemShowType": 0,
                    "listenItem": "",
                    "listenItemExt": null,
                    "moreActionJumpUrl": "",
                    "msgid": 0,
                    "nonceId": "",
                    "pbRequestMsgInfo": null,
                    "picCount": 0,
                    "picUrls": null,
                    "poiInfo": null,
                    "preloadPictureInfo": {
                      "cdnUrl": "https://mmbiz.qpic.cn/sz_mmbiz_png/QaRWjMxooXsW7TibwT4y2L0FVQ7Hb6q4vQNeQzhaEZggC2Mlhxn0Xe5Vk2ian1ewNX4PROqwuK9tEw7qlC0bkp9FhlHUqibGQibLk5vDVj9cjoQ/640?wx_fmt=png&from=appmsg&wxfrom=206",
                      "pbRequestMsgInfo": null
                    },
                    "sendTime": 1790687981,
                    "shortShowDesc": "5504 likes  ",
                    "showDesc": "100k+ reads  5504 likes  ",
                    "sourceUrl": "https://www.peopleapp.com",
                    "textTitle": "",
                    "tid": "",
                    "title": "【夜读】你相信什么，就会发生什么",
                    "videoDuration": 0,
                    "videoHeight": 0,
                    "videoId": "",
                    "videoWidth": 0,
                    "voiceId": "",
                    "voiceType": 0,
                    "wxaEditJumpUrl": ""
                  }
                ],
                "pbRequestMsgInfo": null
              },
              "baseInfo": {
                "dateTime": 1790687967,
                "funcFlag": 0,
                "msgId": 2667036897,
                "msgType": 49,
                "pbRequestMsgInfo": null,
                "status": 0,
                "uniqueId": "0_2667036897",
                "virtualMsgType": 0
              },
              "featuredExposed": false,
              "image": null,
              "pbRequestMsgInfo": null,
              "text": null,
              "video": null,
              "voice": null
            },
            {
              "appMsg": {
                "baseInfo": {
                  "appMsgId": 2667036881,
                  "bigPic": 1,
                  "createTime": 1790685094,
                  "hasExpanded": false,
                  "pbRequestMsgInfo": null,
                  "type": 9,
                  "updateTime": 1790686415
                },
                "detailInfo": [
                  {
                    "appEditJumpUrl": "",
                    "audioDuRation": 0,
                    "audioId": 0,
                    "audioPlayUrl": "",
                    "authorDesc": "",
                    "canModifyByWxa": 0,
                    "contentUrl": "http://mp.weixin.qq.com/s?__biz=MjM5MjAxNDM4MA==&mid=2667036881&idx=1&sn=653000c2b7685c29df1a90d978658625&chksm=bccdcb0ee5cbc04b5f582375eea01d9fbedc228318caf84d2cf2ba99193a3ade6c3fef92e8fc&scene=126&sessionid=0#rd",
                    "coverImgUrl": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/QaRWjMxooXugWmGWeF2c8ovf9GMKJOheTicvJuUlOaWr9lrBdZ8ic0PqFSibsTRJibN0799COqMlO9AzO95hiczSJBRdLQJIRiaiccBt0ibSlZpfWoc/640?wxtype=jpeg&wxfrom=25",
                    "coverImgUrl11": "https://mmbiz.qpic.cn/mmbiz_jpg/QaRWjMxooXvnX00BvReUe2cgrFCgMJIrDM00j4Xb3TDkjkWQ45n9czxuHzroZyTpZauhw6G9olXRicTn00Y8TOcaNv0vElgg0luwAYosHBaE/300?wxtype=jpeg&wxfrom=25",
                    "coverImgUrl169": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/QaRWjMxooXugWmGWeF2c8ovf9GMKJOheTicvJuUlOaWr9lrBdZ8ic0PqFSibsTRJibN0799COqMlO9AzO95hiczSJBRdLQJIRiaiccBt0ibSlZpfWoc/640?wxtype=jpeg&wxfrom=25",
                    "coverImgUrl169640": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/QaRWjMxooXugWmGWeF2c8ovf9GMKJOheTicvJuUlOaWr9lrBdZ8ic0PqFSibsTRJibN0799COqMlO9AzO95hiczSJBRdLQJIRiaiccBt0ibSlZpfWoc/640?wxtype=jpeg&wxfrom=25",
                    "coverImgUrl2351": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/QaRWjMxooXugWmGWeF2c8ovf9GMKJOheTicvJuUlOaWr9lrBdZ8ic0PqFSibsTRJibN0799COqMlO9AzO95hiczSJBRdLQJIRiaiccBt0ibSlZpfWoc/640?wxtype=jpeg&wxfrom=25",
                    "coverimgurl34": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/QaRWjMxooXugWmGWeF2c8ovf9GMKJOheTicvJuUlOaWr9lrBdZ8ic0PqFSibsTRJibN0799COqMlO9AzO95hiczSJBRdLQJIRiaiccBt0ibSlZpfWoc/540?wxtype=jpeg&wxfrom=25",
                    "createTime": 0,
                    "digest": "",
                    "featuredInfo": {
                      "appMsgId": 0,
                      "featured": 0,
                      "itemIndex": 0,
                      "pbRequestMsgInfo": null,
                      "status": 0
                    },
                    "finderFeedXml": "",
                    "finderLive": null,
                    "isModified": 0,
                    "isPaid": 0,
                    "isPaySubscribe": 0,
                    "itemIndex": 1,
                    "itemShowType": 0,
                    "listenItem": "",
                    "listenItemExt": null,
                    "moreActionJumpUrl": "",
                    "msgid": 0,
                    "nonceId": "",
                    "pbRequestMsgInfo": null,
                    "picCount": 0,
                    "picUrls": null,
                    "poiInfo": null,
                    "preloadPictureInfo": {
                      "cdnUrl": "https://mmbiz.qpic.cn/mmbiz_jpg/8qpyZOZGOIQsMVJX4KdcVxic23yoV2ZgNN6VXmta9Nic31YLXM5SgQmxP9JSuiaVkmIpLYm3YtO1GkFOLiaB32ic0pLYBk9ChbPWfRhqLUApZfd0/640?wx_fmt=jpeg&wxfrom=206&tp=wxpic#imgIndex=0",
                      "pbRequestMsgInfo": null
                    },
                    "sendTime": 1790685600,
                    "shortShowDesc": "5083 likes  ",
                    "showDesc": "100k+ reads  5083 likes  ",
                    "sourceUrl": "https://www.peopleapp.com/home",
                    "textTitle": "",
                    "tid": "",
                    "title": "北京理工大学发布情况通报",
                    "videoDuration": 0,
                    "videoHeight": 0,
                    "videoId": "",
                    "videoWidth": 0,
                    "voiceId": "",
                    "voiceType": 0,
                    "wxaEditJumpUrl": ""
                  }
                ],
                "pbRequestMsgInfo": null
              },
              "baseInfo": {
                "dateTime": 1790685600,
                "funcFlag": 0,
                "msgId": 2667036881,
                "msgType": 49,
                "pbRequestMsgInfo": null,
                "status": 0,
                "uniqueId": "0_2667036881",
                "virtualMsgType": 0
              },
              "featuredExposed": false,
              "image": null,
              "pbRequestMsgInfo": null,
              "text": null,
              "video": null,
              "voice": null
            },
            {
              "appMsg": {
                "baseInfo": {
                  "appMsgId": 2667036877,
                  "bigPic": 1,
                  "createTime": 1790683310,
                  "hasExpanded": false,
                  "pbRequestMsgInfo": null,
                  "type": 9,
                  "updateTime": 1790684093
                },
                "detailInfo": [
                  {
                    "appEditJumpUrl": "",
                    "audioDuRation": 0,
                    "audioId": 0,
                    "audioPlayUrl": "",
                    "authorDesc": "",
                    "canModifyByWxa": 0,
                    "contentUrl": "http://mp.weixin.qq.com/s?__biz=MjM5MjAxNDM4MA==&mid=2667036877&idx=1&sn=6f1df461a4a83e6e7e5c429c428925d8&chksm=bcddeb3f392f334859b7c2a326d37323531413aa5be319902bbd3d2005d4589ceb4033e1753a&scene=126&sessionid=0#rd",
                    "coverImgUrl": "https://mmbiz.qpic.cn/mmbiz_jpg/QaRWjMxooXuhwDYpkZoRK9ERoCnOOt3I0za0XAwgicM3fpfvNSPwePn4EialWS8JINibQy4QnWNVgdVYOWbl496Rfoade96ewo8ibSAKmZaQaCM/640?wxtype=jpeg&wxfrom=25",
                    "coverImgUrl11": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/QaRWjMxooXvuxsZYXqgS40cVcTqPyOaqfX4D4Ticz3bGbs1d9jWJJx7P2dd5jaVG5GPkntXPiaKzAJkxtmic3fnDmPCKASf1XyrbdRSnicXmVibo/300?wxtype=jpeg&wxfrom=25",
                    "coverImgUrl169": "https://mmbiz.qpic.cn/mmbiz_jpg/QaRWjMxooXuhwDYpkZoRK9ERoCnOOt3I0za0XAwgicM3fpfvNSPwePn4EialWS8JINibQy4QnWNVgdVYOWbl496Rfoade96ewo8ibSAKmZaQaCM/640?wxtype=jpeg&wxfrom=25",
                    "coverImgUrl169640": "https://mmbiz.qpic.cn/mmbiz_jpg/QaRWjMxooXuhwDYpkZoRK9ERoCnOOt3I0za0XAwgicM3fpfvNSPwePn4EialWS8JINibQy4QnWNVgdVYOWbl496Rfoade96ewo8ibSAKmZaQaCM/640?wxtype=jpeg&wxfrom=25",
                    "coverImgUrl2351": "https://mmbiz.qpic.cn/mmbiz_jpg/QaRWjMxooXuhwDYpkZoRK9ERoCnOOt3I0za0XAwgicM3fpfvNSPwePn4EialWS8JINibQy4QnWNVgdVYOWbl496Rfoade96ewo8ibSAKmZaQaCM/640?wxtype=jpeg&wxfrom=25",
                    "coverimgurl34": "https://mmbiz.qpic.cn/mmbiz_jpg/QaRWjMxooXuhwDYpkZoRK9ERoCnOOt3I0za0XAwgicM3fpfvNSPwePn4EialWS8JINibQy4QnWNVgdVYOWbl496Rfoade96ewo8ibSAKmZaQaCM/540?wxtype=jpeg&wxfrom=25",
                    "createTime": 0,
                    "digest": "",
                    "featuredInfo": {
                      "appMsgId": 0,
                      "featured": 0,
                      "itemIndex": 0,
                      "pbRequestMsgInfo": null,
                      "status": 0
                    },
                    "finderFeedXml": "",
                    "finderLive": null,
                    "isModified": 0,
                    "isPaid": 0,
                    "isPaySubscribe": 0,
                    "itemIndex": 1,
                    "itemShowType": 0,
                    "listenItem": "",
                    "listenItemExt": null,
                    "moreActionJumpUrl": "",
                    "msgid": 0,
                    "nonceId": "",
                    "pbRequestMsgInfo": null,
                    "picCount": 0,
                    "picUrls": null,
                    "poiInfo": null,
                    "preloadPictureInfo": {
                      "cdnUrl": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/QaRWjMxooXuSicc8MFVXcgsqEgn6sjTHqhzP7MibFadtV5ahrQjrcrakGbk5gY6yULPvFJ5s1qWEZgIsh0J2V8R4iaH8Q5Kr1z8Dgu8QfjXa1c/640?wx_fmt=jpeg&from=appmsg&tp=webp&wxfrom=206&wx_lazy=1#imgIndex=0",
                      "pbRequestMsgInfo": null
                    },
                    "sendTime": 1790683321,
                    "shortShowDesc": "2264 likes  ",
                    "showDesc": "100k+ reads  2264 likes  ",
                    "sourceUrl": "https://www.peopleapp.com/",
                    "textTitle": "",
                    "tid": "",
                    "title": "三文鱼到底能不能生吃？",
                    "videoDuration": 0,
                    "videoHeight": 0,
                    "videoId": "",
                    "videoWidth": 0,
                    "voiceId": "",
                    "voiceType": 0,
                    "wxaEditJumpUrl": ""
                  }
                ],
                "pbRequestMsgInfo": null
              },
              "baseInfo": {
                "dateTime": 1790683310,
                "funcFlag": 0,
                "msgId": 2667036877,
                "msgType": 49,
                "pbRequestMsgInfo": null,
                "status": 0,
                "uniqueId": "0_2667036877",
                "virtualMsgType": 0
              },
              "featuredExposed": false,
              "image": null,
              "pbRequestMsgInfo": null,
              "text": null,
              "video": null,
              "voice": null

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.01 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

username
string · required
raw
boolean · optional

Access

Provider
WeChat MP
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/wechat-mp/v2/account-profile
Authentication
Bearer API key

API README

WeChat MP Account Profile API

Look up official WeChat account profile information by passing the account ID in username.

Use cases

  • Verify official WeChat account details such as verification status and entity type.
  • Display official account avatar, nickname, and signature in external dashboards.
  • Inspect raw or simplified profile data structures for integrated WeChat monitoring tools.

Request

curl -X POST "https://api.sandbase.ai/v1/api/wechat-mp/v2/account-profile" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "<username>"}'

Parameters

NameTypeRequiredDescription
usernamestringYesOfficial account gh_username (gh_…).
rawbooleanNoOptional, default True.

Notes

  • Set username using the gh_ ID obtained from article details or WeChat search results.
  • Set raw to false for simplified parsing, or keep it true by default for raw profile data.
  • Profile fields such as nickname, signature, or avatar URL may return as null.

Related APIs

  • WeChat MP Account Articles: Get the published articles of a WeChat official account by its gh_ username: titles, links, covers and post dates, one page at a time, including video and audi…
  • WeChat MP Article Ads: Returns embedded ad slot information for a specified WeChat MP article URL.
  • WeChat MP Article Comments: Get the comments on a WeChat official account article from its URL: comment text, likes, time and commenter region, with cursor pagination.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/wechat-mp/v2/account-profile
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/wechat-mp/v2/account-profile" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "username": "gh_363b924965e9"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
WeChat MP Account ProfileThis API
WeChat MP		$0.01 per callJSONJul 31, 2026
WeChat MP Account Articles
WeChat MP		$0.01 per callJSONJul 31, 2026
WeChat MP Article Ads
WeChat MP		$0.01 per callJSONJul 31, 2026
WeChat MP Article Comments
WeChat MP		$0.01 per callJSONJul 31, 2026
WeChat MP Article Detail
WeChat MP		$0.01 per callJSONJul 31, 2026
WeChat MP Article Stats
WeChat MP		$0.01 per callJSONJul 31, 2026

Questions

FAQ

How do I use the WeChat MP Account Profile API?

Send a POST request to https://api.sandbase.ai/v1/api/wechat-mp/v2/account-profile with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the WeChat MP Account Profile API cost?

$0.01 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the WeChat MP Account Profile API accept?

Required: username (string). Optional: raw (boolean). The Parameters table and the Playground on this page list every field.

What does the WeChat MP Account Profile API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a WeChat MP developer account or API key?

No. WeChat MP Account Profile runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for WeChat MP API access separately.