Users/search
(创建新页面为 '== searchuser == 返回关键字匹配的微博。 === URL=== http://api.t.sina.com.cn/searchuser.format === 格式=== xml, json === HTTP请求方式=== GET === 是否需…') |
(→searchuser) |
||
第19行: | 第19行: | ||
===请求参数=== | ===请求参数=== | ||
* q: 选填参数. 查询的关键字。必须进行[http://en.wikipedia.org/wiki/URL_encoding url encode] | * q: 选填参数. 查询的关键字。必须进行[http://en.wikipedia.org/wiki/URL_encoding url encode] | ||
− | :o 示例: http://api.t.sina.com.cn/ | + | :o 示例: http://api.t.sina.com.cn/searchuser.json?q=api |
* snick: 选填参数. 搜索范围包含昵称 (0是不包含,1为包含) | * snick: 选填参数. 搜索范围包含昵称 (0是不包含,1为包含) | ||
− | :o 示例: http://api.t.sina.com.cn/ | + | :o 示例: http://api.t.sina.com.cn/searchuser.json?q=api&snick=0 |
* sdomain: 选填参数. 搜索范围包含个性域名 (0是不包含,1为包含) | * sdomain: 选填参数. 搜索范围包含个性域名 (0是不包含,1为包含) | ||
− | :o 示例: http://api.t.sina.com.cn/ | + | :o 示例: http://api.t.sina.com.cn/searchuser.json?q=api&sdomain=1 |
* sintro: 选填参数. 搜索范围包含简介 (0是不包含,1为包含) | * sintro: 选填参数. 搜索范围包含简介 (0是不包含,1为包含) | ||
− | :o 示例: http://api.t.sina.com.cn/ | + | :o 示例: http://api.t.sina.com.cn/searchuser.json?q=api&sintro=1 |
* province: 省份ID | * province: 省份ID | ||
− | :o 示例: http://api.t.sina.com.cn/ | + | :o 示例: http://api.t.sina.com.cn/searchuser.json?province=11 |
− | * city: | + | * city: 城市ID |
− | :o 示例: http://api.t.sina.com.cn/ | + | :o 示例: http://api.t.sina.com.cn/searchuser.json?province=11&city=1 |
* gender: 性别(m为男,f为女) | * gender: 性别(m为男,f为女) | ||
− | :o 示例: http://api.t.sina.com.cn/ | + | :o 示例: http://api.t.sina.com.cn/searchuser.json?gender=m |
* comorsch: 公司学校名称 | * comorsch: 公司学校名称 | ||
− | :o 示例: http://api.t.sina.com.cn/ | + | :o 示例: http://api.t.sina.com.cn/searchuser.json?comorsch=新浪 |
* sort: 排序方式(1为按更新时间,2为按粉丝数) | * sort: 排序方式(1为按更新时间,2为按粉丝数) | ||
− | :o 示例: http://api.t.sina.com.cn/ | + | :o 示例: http://api.t.sina.com.cn/searchuser.json?q=api&sort=1 |
* page: 页码 | * page: 页码 | ||
− | :o 示例: http://api.t.sina.com.cn/ | + | :o 示例: http://api.t.sina.com.cn/searchuser.json?q=api&sort=1&page=1 |
* count:分页大小(默认返回10条) | * count:分页大小(默认返回10条) | ||
− | :o 示例: http://api.t.sina.com.cn/ | + | :o 示例: http://api.t.sina.com.cn/searchuser.json?q=api&sort=1&page=1&count=10 |
* callback: 可选参数. 仅JSON方式支持,用于JSONP callback作用。 | * callback: 可选参数. 仅JSON方式支持,用于JSONP callback作用。 | ||
− | :o 示例: http://api.t.sina.com.cn/ | + | :o 示例: http://api.t.sina.com.cn/searchuser.json?q=api&callback=foo |
=== 返回结果 === | === 返回结果 === | ||
第49行: | 第49行: | ||
* xml: | * xml: | ||
− | curl http://api.t.sina.com.cn/ | + | curl http://api.t.sina.com.cn/searchuser.xml?q=api |
* json: | * json: | ||
− | curl http://api.t.sina.com.cn/ | + | curl http://api.t.sina.com.cn/searchuser.json?q=api |
2010年1月26日 (二) 11:27的版本
目录 |
searchuser
返回关键字匹配的微博。
URL
http://api.t.sina.com.cn/searchuser.format
格式
xml, json
HTTP请求方式
GET
是否需要登录
true
请求数限制
true
请求参数
- q: 选填参数. 查询的关键字。必须进行url encode
- snick: 选填参数. 搜索范围包含昵称 (0是不包含,1为包含)
- sdomain: 选填参数. 搜索范围包含个性域名 (0是不包含,1为包含)
- sintro: 选填参数. 搜索范围包含简介 (0是不包含,1为包含)
- province: 省份ID
- city: 城市ID
- gender: 性别(m为男,f为女)
- comorsch: 公司学校名称
- sort: 排序方式(1为按更新时间,2为按粉丝数)
- page: 页码
- count:分页大小(默认返回10条)
- callback: 可选参数. 仅JSON方式支持,用于JSONP callback作用。
返回结果
XML示例:
使用示例
- xml:
curl http://api.t.sina.com.cn/searchuser.xml?q=api
- json: