基础接口

使用以下接口代表你已同意并遵守 《美拍开放平台Open API使用协议》

展示接口接入指南

获取频道 / 话题的美拍封面和美拍详情页 URL 地址

URL

http://newapi.meipai.com/output/channels_topics_timeline.json

支持格式

JSON

HTTP 请求方式

GET

是否需要认证

请求参数

参数 是否必选 类型及范围 说明
id true int

话题 id 或频道 id,其中频道目前支持的有:

  • 热门(ID:1)
  • 搞笑(ID:13)
  • 明星名人(ID:16)
  • 男神(ID:31)
  • 女神(ID:19)
  • 音乐(ID:62)
  • 舞蹈(ID:63)
  • 美食(ID:59)
  • 美妆(ID:27)
  • 宝宝(ID:18)
  • 萌宠(ID:6)
  • 手工(ID:450)
  • 穿秀(ID:460)
  • 吃秀(ID:423)
topic_name true string 话题名称(若传了话题名称则根据话题名称搜索不根据 id 搜索,id 字段可不传)
count false int 单页返回的记录条数,默认为 20,最多 100。
page false int 返回结果的页码,默认为1。
feature false string 排序方式,new 表示最新,hot 表示最热,频道默认为最新,话题默认为最热
max_id false int 若取最新,需传此字段,为当前分页最后一个美拍的 ID,用于获取下一页时定位

注意事项

暂无

返回结果

[
    {
        "id": 10000000001,
        "user_id": 100000,
        "url": "http://www.meipai.com/media/10000000001",
        "cover_pic": "http://mvimg1.meitudata.com/xxxxxxxxx.jpg!thumb320",
        "screen_name": "meipai01",
        "caption": "美拍开放平台",
        "avatar": "http://mvavatar4.meitudata.com/xxxxxxxxx.jpg",
        "plays_count": 100,
        "comments_count": 100,
        "likes_count": 100,
        "created_at": 1459307395,
    },
    {
        "id": 10000000002,
        "user_id": 100000,
        "url": "http://www.meipai.com/media/10000000002",
        "cover_pic": "http://mvimg1.meitudata.com/xxxxxxxxx.jpg!thumb320",
        "screen_name": "meipai02",
        "caption": "美拍开放平台",
        "avatar": "http://mvavatar4.meitudata.com/xxxxxxxxx.jpg",
        "plays_count": 100,
        "comments_count": 100,
        "likes_count": 100,
        "created_at": 1459307395,
    },
    ...
]

返回字段说明

返回值字段 字段类型 字段说明
id int 视频 id
user_id int 用户id
url string 视频链接
cover_pic string 视频封面
screen_name string 视频作者昵称
caption string 视频描述
avatar string 视频作者头像
plays_count int 播放数
comments_count int 评论数
likes_count int 点赞数
created_at int 视频创建时间(时间戳)

错误返回值格式

{
    "error_code": "10107",
    "error": "系统错误",
    "error_detail": "参数不合法",
    "request": "/output/channels_topics_timeline.json"
}
返回码说明