# 接口目录:lists/urls
* * *
### 简要描述:
* 获取短网址列表,与用户中心的我的短网址界面功能相同
### 调用收费:
> 1点击额度/次
### 是否需要授权才能调用:
**是**,详情请参阅左侧导航《接口鉴权》小节
### 请求URL:
~~~
http://api.fof.ink/lists/urls
~~~
### 请求方式:
`POST`
### 请求参数:
| 参数名 | 是否必须 | 类型 | 说明 |
| --- | --- | --- | --- |
| page | 否 | int | 页码,默认1 |
| time\_range\_start | 否 | int/string | 筛选指定时间起的短网址,可以是unix时间戳,也可以是yyyy-MM-dd HH:mm:ss格式 |
| time\_range\_end | 否 | int/string | 筛选指定时间末的短网址,可以是unix时间戳,也可以是yyyy-MM-dd HH:mm:ss格式 |
| tag\_name | 否 | string | 筛选含有指定标签的短网址,不含指定标签的短网址会被过滤掉 |
| filter\_no\_click | 否 | string | 是否过滤掉没有点击的点网址,默认不过滤,如需要过滤,设置值为on |
### 返回示例:
~~~
{
"status": 1,
"info": "urls lists fetch success",
"data": {
"total": 2,
"page_size": 20,
"current_page": 1,
"urls": [
{
"tags": [
"tag1",
"tag2"
],
"click_count":0,
"short_url": "https://fof.ink/ltuK",
"real_url": "https://www.bilibili.com/video/bangumi-two-1.html",
"nht_protect": 1,
"click_password": "N/A",
"create_time": 1489300918,
"enable_target": 0,
"source": "N/A"
},
{
"tags": [
"tag1"
],
"click_count":0,
"short_url": "http://fof.ink/qNrU",
"real_url": "http://news.163.com/",
"nht_protect": 0,
"click_password": "N/A",
"create_time": 1489297741,
"enable_target": 0,
"source": "网易新闻"
}
]
}
}
~~~
### 返回data字段说明:
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| total | int | 短网址总数 |
| page\_size | int | 每页数据数量,固定20 |
| current\_page | int | 当前所在页数 |
| urls | array | 短网址详情 |
### 备注:
* `time_range_start`和`time_range_end`必须同时使用,不能只含其中一个