查询账号详情_文档中心_MCNDATA数据开放平台

查询账号详情

接口描述

通过账号ID查询账号名称、头像、介绍、认证信息、基础数据等信息。

请求地址

接口地址：https://api.shuwen.com/mcndata/media/detail

请求方式：GET

请求头

参数	是否必填	类型	描述
sw-access-key	必填	String	AccessKey

请求参数

参数	是否必填	类型	描述
timestamp	必填	Long	毫秒级时间戳
signature	必填	String	签名信息，详见接口鉴权
mid	必填	String	账号ID

响应结果

以下仅列出了接口响应结果，公共响应结果见请求响应结果。

字段	允许为空	类型	描述
mid	否	String	账号ID
name	否	String	账号名称
platform	否	String	平台别名
avatar	否	String	账号头像
description	否	String	账号描述
is_verified	否	Integer	账号认证状态，1为认证账号，0为未认证账号
verify_info	是	String	账号认证信息，未认证的账号返回空
url	否	String	账号个人主页
fans_count	否	Integer	粉丝数

请求额度

单个应用每日的请求次数如下：

应用状态	请求额度
体验	10次/天
正式	50,000次/天

请求示例

下面使用Python实现该接口调用，开发者可以参考实现其他语言的版本。

import requests
import time
import hashlib

# 应用ak和sk
access_key = "YOUR_ACCESS_KEY"
secret_key = "YOUR_SECRET_KEY"

# 13位的当前时间戳
timestamp = round(time.time() * 1000)


# 生成签名
def getSignature(access_key, secret_key, timestamp):
    temp = secret_key + str(timestamp) + access_key
    return hashlib.md5(temp.encode(encoding="UTF-8")).hexdigest()

# 签名后的字符串
signature = getSignature(access_key, secret_key, timestamp)

# 请求url
url = "https://api.shuwen.com/mcndata/media/detail"

# 请求头
headers = {
  "sw-access-key": access_key
}

# 请求参数
params = {
    "timestamp": timestamp,
    "signature": signature,
    "mid": "445052"  # 账号ID
}

# 发起http请求
response = requests.get(url, params=params, headers=headers)
print(response.content.decode("utf8"))复制

响应示例

{
    "success": true,
    "code": "0",
    "msg": "Success",
    "requestId": "http-nio-8080-exec-195_0ac34a542b31441c81d1eab5155aa651",
    "data": {
        "fans_count": 879029,
        "name": "央视新闻",
        "description": "中央电视台央视新闻官方账号",
        "mid": "445052",
        "avatar": "https://mcn.newscdn.cn/cover/media/20200413/4a771ec97624a504a4d8483bc12aa091.jpg",
        "is_verified": 1,
        "platform": "uc",
        "url": "https://www.mcndata.cn/link/1H9fmXC",
        "verify_info": "中央电视台央视新闻官方账号"
    }
}复制