文档目录
从这里开始

搜索结果分页

分页与搜索引擎

搜索引擎的目的是尽快为用户找到他们搜索的数据,同时用户在使用搜索引擎时通常有较高的准确度期望。

因此,搜索引擎如果不能在第 1 页,甚至前 3 个结果中,为用户找到内容,用户就会立即离开。

结合你使用百度或谷歌的体验,很少有在第一页找完过后,继续找第二页的经历。

在这样的预期下,为用户快速准确地找到一个短列表来选择的重要性,远超过找到完整的结果来给用户一个个人工选择。因此,如果你需要翻页时,请从用户体验的角度考虑分页是否一定必要。

卡拉搜索的分页

在卡拉搜索的搜索请求中,我们用两个参数来控制分页

page

从 0 开始的整数,代表当前请求的页数。

hitsPerPage

代表每页需要返回的结果数

分页限制

请注意,hitsPerPage 的值需要在 [1, 100] 范围内。也即在分页参数中,每次要求搜索引擎返回的结果数不能超过 100 个

这个限制不光是为了保证响应速度,以此保证你的用户的用户体验,同时也防止你的数据被爬虫轻易抓走。对于绝大多数使用场景来说, 100 每页的返回数都绰绰有余。

同时,要求返回的结果数也不会超过查询本身返回的对象数。比如说,如果你的查询只有 3 个对象匹配(搜索电影无间道,而只有 3 部电影满足查询)而你用 page=1, hitsPerPage = 10 的话,结果仍然只会返回 3 个对象。

请求示例

{
"query": "爱情片",
"hitsPerPage": 5,
"page": 0
}
友情链接更新日志© 2020, 卡拉搜索, Built with ❤️ in San Francisco + Beijing

京ICP备15049164号-3