查询账号详情

接口描述

通过账号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": "中央电视台央视新闻官方账号"
    }
}复制