C/2/app news/v1/business
app news/v1/business
通过条件查询相关新闻及视频内容。
URL
https://c.api.weibo.com/2/app news/v1/business.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
请求所有商业接口:
- 50000次/小时/IP;
- 50000次/小时/IP;
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
tp | true | string | 查询类别,news或video, 默认news。 |
q | false | string | 查询关键词,做urlencode处理,以英⽂逗号分割,最多10个词。 |
media_id | false | string | 查询作者ID,以英⽂逗号分割,最多50个词。 |
tag | false | string | 查询标签,通过标签查询, 以英⽂逗号分割,最多10个词。 |
scroll_id | false | string | 游标id,再次查询读取接口通过scroll_id查询后面的数据,直到scroll_id为空。 |
starttime | false | int | 搜索范围起始时间,取值为unix时间戳,单位为秒。 |
endtime | false | int | 搜索范围结束时间,取值为unix时间戳,单位为秒。 |
count | false | int | 每页返回数量,最⼩50, 最⼤100, 默认50。 |
注意事项
- 当scroll_id为空时,q,media_id,tag 三者必传其⼀;
- 再次取数据,查询scroll_id,类似游标查询。
返回结果
JSON示例
{ "statuses": [ { "created_at": "Tue May 31 17:46:55 +0800 2011", "id": 11488058246, "text": "求关注。", "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>", "favorited": false, "truncated": false, "in_reply_to_status_id": "", "in_reply_to_user_id": "", "in_reply_to_screen_name": "", "geo": null, "mid": "5612814510546515491", "reposts_count": 8, "comments_count": 9, "annotations": [], "user": { "id": 1404376560, "screen_name": "zaku", "name": "zaku", "province": "11", "city": "5", "location": "北京 朝阳区", "description": "人生五十年,乃如梦如幻;有生斯有死,壮士复何憾。", "url": "http://blog.sina.com.cn/zaku", "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1", "domain": "zaku", "gender": "m", "followers_count": 1204, "friends_count": 447, "statuses_count": 2908, "favourites_count": 0, "created_at": "Fri Aug 28 00:00:00 +0800 2009", "following": false, "allow_all_act_msg": false, "remark": "", "geo_enabled": true, "verified": false, "allow_all_comment": true, "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1", "verified_reason": "", "follow_me": false, "online_status": 0, "bi_followers_count": 215 } }, ... ], "total_number": 16 }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
scroll_id | string | 用于再次查询的游标位置,scroll_id, 5分钟有效期。 |
dataid | string | 文档ID,查询的内容id。 |
url | string | 文档链接,查询的内容链接。 |
title | string | 内容的标题。 |
thumb | string | 内容的封面图。 |
thumbs | string | 内容的配图。 |
content | string | 文档的正文内容。 |
tags | string | 标签名称。 |
media_id | string | 媒体作者的id。 |
media | string | 媒体作者的名称。 |
ctime | string | 内容的创建时间。 |
total | int | 查询的总条数。 |
count | int | 本次返回条数。 |
其他
无