Statuses/search
(→请求参数) |
(→请求参数) |
||
第19行: | 第19行: | ||
===请求参数=== | ===请求参数=== | ||
* q: 选填参数. 查询的关键字。必须进行[http://en.wikipedia.org/wiki/URL_encoding url encode] | * q: 选填参数. 查询的关键字。必须进行[http://en.wikipedia.org/wiki/URL_encoding url encode] | ||
− | : | + | ::示例: http://api.t.sina.com.cn/statuses/search.json?q=api |
* filter_ori: 选填参数.过滤器,是否原创 (0为全部,5为原创,4为转发,默认0) | * filter_ori: 选填参数.过滤器,是否原创 (0为全部,5为原创,4为转发,默认0) | ||
− | : | + | ::示例: http://api.t.sina.com.cn/statuses/search.json?q=api&filter_ori=0 |
* filter_pic: 选填参数. 过滤器,是否含图 (0为全部,1为含图,2为不含图) | * filter_pic: 选填参数. 过滤器,是否含图 (0为全部,1为含图,2为不含图) | ||
− | : | + | :: 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&filter_pic=1 |
* fuid: 选填参数. 微博作者UID | * fuid: 选填参数. 微博作者UID | ||
− | : | + | :: 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&fuid=11075 |
* province: 省份ID | * province: 省份ID | ||
− | : | + | :: 示例: http://api.t.sina.com.cn/statuses/search.json?province=11 |
* city: 城市ID | * city: 城市ID | ||
− | : | + | :: 示例: http://api.t.sina.com.cn/statuses/search.json?province=11&city=1 |
* starttime: 开始时间(unix时间戳) | * starttime: 开始时间(unix时间戳) | ||
− | : | + | :: 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&starttime=1256289598 |
* endtime: 截止时间 (unix时间戳) | * endtime: 截止时间 (unix时间戳) | ||
− | : | + | :: 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&endtime=1256289598 |
* page: 选填参数,页码(从1开始, 默认1) | * page: 选填参数,页码(从1开始, 默认1) | ||
− | : | + | :: 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&sort=1&page=1 |
* count(别名:rpp):选填参数,每页返回的微博数,默认返回10条,最大200 | * count(别名:rpp):选填参数,每页返回的微博数,默认返回10条,最大200 | ||
− | : | + | :: 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&sort=1&page=1&count=10 |
* callback: 可选参数. 仅JSON方式支持,用于JSONP callback作用。 | * callback: 可选参数. 仅JSON方式支持,用于JSONP callback作用。 | ||
− | : | + | :: 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&callback=foo |
* needcount: 可选参数. 是否返回搜索结果数开关量,可选true/false,值为true时,返回值中,增加搜索结果数量字段。 | * needcount: 可选参数. 是否返回搜索结果数开关量,可选true/false,值为true时,返回值中,增加搜索结果数量字段。 | ||
− | : | + | :: 示例: http://api.t.sina.com.cn/statuses/search.xml?source=appkey&q=php&needcount=true |
+ | * base_app: 可选参数. 是否按照当前应用信息对搜索结果进行过滤,可选True/False或者1/0,值为True/1时,返回值中,仅返回通过该应用发送的微博。 | ||
+ | :: 示例: http://api.t.sina.com.cn/statuses/search.xml?source=appkey&q=php&base_app=1 | ||
=== 返回结果 === | === 返回结果 === |
2010年11月24日 (三) 13:35的版本
目录 |
statuses/search
返回关键字匹配的微博。
URL
http://api.t.sina.com.cn/statuses/search.format
格式
xml, json
HTTP请求方式
GET
是否需要登录
true
请求数限制
true
请求参数
- q: 选填参数. 查询的关键字。必须进行url encode
- filter_ori: 选填参数.过滤器,是否原创 (0为全部,5为原创,4为转发,默认0)
- filter_pic: 选填参数. 过滤器,是否含图 (0为全部,1为含图,2为不含图)
- fuid: 选填参数. 微博作者UID
- province: 省份ID
- city: 城市ID
- starttime: 开始时间(unix时间戳)
- endtime: 截止时间 (unix时间戳)
- page: 选填参数,页码(从1开始, 默认1)
- count(别名:rpp):选填参数,每页返回的微博数,默认返回10条,最大200
- callback: 可选参数. 仅JSON方式支持,用于JSONP callback作用。
- needcount: 可选参数. 是否返回搜索结果数开关量,可选true/false,值为true时,返回值中,增加搜索结果数量字段。
- base_app: 可选参数. 是否按照当前应用信息对搜索结果进行过滤,可选True/False或者1/0,值为True/1时,返回值中,仅返回通过该应用发送的微博。
返回结果
XML示例:
<?xml version="1.0" encoding="UTF-8"?> <searchResult> <statuses> <status> <created_at>Tue Jan 26 14:11:31 +0800 2010</created_at> <id>2471249</id> <text>喜欢巧克力的上去咬啊!^_^</text> <source> <a href="http://t.sina.com.cn">转发</a> </source> <favorited>false</favorited> <truncated>false</truncated> <geo/> <in_reply_to_status_id></in_reply_to_status_id> <in_reply_to_user_id></in_reply_to_user_id> <in_reply_to_screen_name></in_reply_to_screen_name> <user> <id>1535939882</id> <screen_name>谢东中</screen_name> <name>谢东中</name> <province>44</province> <city>1</city> <location>广东 广州</location> <description>无字天书</description> <profile_image_url>http://tp3.sinaimg.cn/1535939882/50/1257243041</profile_image_url> <domain>dongzhong</domain> <gender></gender> <email></email> <qq>20034115</qq> <msn>xiedzh_keeper@hotmail.com</msn> <followers_count>90</followers_count> <friends_count>187</friends_count> <statuses_count>84</statuses_count> <favourites_count>0</favourites_count> <created_at>Fri Oct 30 00:00:00 +0800 2009</created_at> <following>false</following> <verified>false</verified> <geo_enabled>false</geo_enabled> </user> <retweeted_status> <created_at>Tue Jan 26 10:02:46 +0800 2010</created_at> <id>2376920</id> <text>巧克力巧克力~美女穿巧克力喽。更多美女&巧克力http://sinaurl.cn/hKYcY</text> <source> <a href="http://t.sina.com.cn">新浪微博</a> </source> <favorited>false</favorited> <truncated>false</truncated> <geo/> <in_reply_to_status_id></in_reply_to_status_id> <in_reply_to_user_id></in_reply_to_user_id> <in_reply_to_screen_name></in_reply_to_screen_name> <thumbnail_pic>http://ss16.sinaimg.cn/thumbnail/5e6d8fb0t7e07aeb4675f&690</thumbnail_pic> <bmiddle_pic>http://ss16.sinaimg.cn/bmiddle/5e6d8fb0t7e07aeb4675f&690</bmiddle_pic> <original_pic>http://ss16.sinaimg.cn/orignal/5e6d8fb0t7e07aeb4675f&690</original_pic> <user> <id>1584238512</id> <screen_name>饭统网</screen_name> <name>饭统网</name> <province>11</province> <city>8</city> <location>北京 海淀区</location> <description>餐饮时尚风向标 有你有味道!</description> <profile_image_url>http://tp1.sinaimg.cn/1584238512/50/1253776480</profile_image_url> <domain>ourfantong</domain> <gender></gender> <email></email> <qq></qq> <msn></msn> <followers_count>1272</followers_count> <friends_count>17</friends_count> <statuses_count>196</statuses_count> <favourites_count>0</favourites_count> <created_at>Thu Sep 24 00:00:00 +0800 2009</created_at> <following>false</following> <verified>true</verified> <geo_enabled>false</geo_enabled> </user> </retweeted_status> </status> <total_count_maybe>4</total_count_maybe> </statuses> </searchResult>
使用示例
- xml:
curl http://api.t.sina.com.cn/statuses/search.xml?q=api
- json: