搜索账号

接口描述

通过关键词搜索账号。

请求地址

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

请求方式:GET

请求头

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

请求参数

参数 是否必填 类型 描述
timestamp 必填 Long 毫秒级时间戳
signature 必填 String 签名信息,详见接口鉴权
platform 可选 String 平台别名,从获取平台列表接口获取平台信息
name 必填 String 账号名称,需URLEncode

响应结果

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

字段 允许为空 类型 描述
mid String 账号ID
name String 账号名称
platform String 平台别名
avatar String 账号头像
description String 账号描述
is_verified Integer 账号认证状态,1为认证账号,0为未认证账号
verify_info String 账号认证信息,未认证的账号返回空
url String 账号个人主页
status Integer 账号状态,1已激活,0未激活,未激活状态的账号无更多数据

请求额度

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

应用状态 请求额度
体验 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/search"

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

# 请求参数
params = {
    "timestamp": timestamp,
    "signature": signature,
    "platform": "uc",  # 平台,可以为空
    "name": "央视新闻"  # 查询的账号名称
}

# 发起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-108_3a8056f8f41c43358cd862ee7152c765",
    "data": [
        {
            "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": "中央电视台央视新闻官方账号",
            "status": 0
        }
    ]
}复制