跳转到: 导航, 搜索

search/geo/statuses

获取指定地点周边的微博列表。

URL

https://api.weibo.com/2/search/geo/statuses.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录


关于登录授权,参见 如何登录授权

访问授权限制

访问级别:高级接口(需要授权)
频次限制:
关于频次限制,参见 接口访问权限说明

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
longitude true float 经度。有效范围:-180.0到+180.0,+表示东经。
latitude true float 纬度。有效范围:-90.0到+90.0,+表示北纬。
range false int 搜索范围,单位米,默认500米,最大11132米。
time false int 返回结果所在的时间段,单位为分钟,指从现在开始之前的时间段。
sort_type false int 排序方式。默认为0,按时间排序;为1时按与中心点距离进行排序。
page false int 返回结果页码。默认为1。
count false int 每页结果数。默认10,最大50。
base_app false int 是否根据当前应用返回数据。默认0:全部应用;1:仅限当前应用。

注意事项

调用样例及调试工具

API测试工具

返回结果

JSON示例

{		
	"statuses":[		
		{
			"created_at":"Mon Apr 18 17:24:52 +0800 2011",
			"id":9307802873,
			"text":"aaa14525",
			"source":"<a href=\"http://t.sina.com.cn/pub/star\" 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":"2111104182474005",
			"user":
			{
				"id":1734528095,
				"screen_name":"jkl0000",
				"name":"jkl0000",
				"province":"12",
				"city":"5",
				"location":"天津 河北区",
				"description":"abcdefag",
				"url":"http://blog.sina.com.cn/jkl0000",
				"profile_image_url":"http://tp4.sinaimg.cn/1734528095/50/1300791951/1",
				"domain":"jkl00",
				"gender":"m",
				"followers_count":155,
				"friends_count":175,
				"statuses_count":1110,
				"favourites_count":3,
				"created_at":"Mon Apr 26 00:00:00 +0800 2010",
				"following":false,
				"allow_all_act_msg":true,
				"geo_enabled":true,
				"verified":false
			}
		},
		{
			"created_at":"Mon Apr 18 17:24:52 +0800 2011",
			"id":9307802873,
			"text":"aaa14525",
			"source":"<a href=\"http://t.sina.com.cn/pub/star\" 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":"2111104182474005",
			"user":
			{
				"id":1734528095,
				"screen_name":"jkl0000",
				"name":"jkl0000",
				"province":"12",
				"city":"5",
				"location":"天津 河北区",
				"description":"abcdefag",
				"url":"http://blog.sina.com.cn/jkl0000",
				"profile_image_url":"http://tp4.sinaimg.cn/1734528095/50/1300791951/1",
				"domain":"jkl00",
				"gender":"m",
				"followers_count":155,
				"friends_count":175,
				"statuses_count":1110,
				"favourites_count":3,
				"created_at":"Mon Apr 26 00:00:00 +0800 2010",
				"following":false,
				"allow_all_act_msg":true,
				"geo_enabled":true,
				"verified":false
			}
		}	
	],
	"total_number":100
}

关于错误返回值与错误代码,参见 错误代码说明

返回字段说明

返回值字段 字段类型 字段说明
created_at string 微博创建时间
id int64 微博ID
mid int64 微博MID
idstr string 字符串型的微博ID
text string 微博信息内容
source string 微博来源
favorited boolean 是否已收藏,true:是,false:否
truncated boolean 是否被截断,true:是,false:否
in_reply_to_status_id string (暂未支持)回复ID
in_reply_to_user_id string (暂未支持)回复人UID
in_reply_to_screen_name string (暂未支持)回复人昵称
thumbnail_pic string 缩略图片地址,没有时不返回此字段
bmiddle_pic string 中等尺寸图片地址,没有时不返回此字段
original_pic string 原始图片地址,没有时不返回此字段
geo object 地理信息字段 详细
user object 微博作者的用户信息字段 详细
retweeted_status object 被转发的原微博信息字段,当该微博为转发微博时返回 详细
reposts_count int 转发数
comments_count int 评论数
attitudes_count int 表态数
mlevel int 暂未支持
visible object 微博的可见性及指定可见分组信息。该object中type取值,0:普通微博,1:私密微博,3:指定分组微博,4:密友微博;list_id为分组的组号
pic_ids object 微博配图ID。多图时返回多图ID,用来拼接图片url。用返回字段thumbnail_pic的地址配上该返回字段的图片ID,即可得到多个图片url。
ad object array 微博流内的推广微博ID

其他

相关问题

{{{relat_qa}}}


帮助中心 查看更多问题或提问


Language: [[{{{2/uri}}}|中文]]




文档更新时间: 2011-06-02
api评价