Algolia搜索函数仅返回前20条结果，如何获取全部验证场地？

核心问题原因 #

你的代码只返回20条结果，主要是因为Algolia Search API的默认限制：

• 免费版/基础计划默认设置paginationLimitedTo=20，超过这个页数的结果无法通过普通搜索请求获取；
• 即使手动设置了hitsPerPage=1000，如果索引的maxHitsPerPage配置值低于1000，实际返回的每页结果数会被强制限制；
• 循环分页搜索并非Algolia获取全量数据的最优方式，官方更推荐使用专门的Browse API遍历全量匹配记录。

解决方案1：调整Search API参数突破分页限制 #

如果坚持使用Search API，需要在请求中显式设置分页上限，并确认索引配置允许足够的每页结果数：

import csv
# 确保index是已初始化完成的Algolia索引实例

def get_all_venues():
    try:
        page = 0
        hits_per_page = 1000
        # 设置分页上限为预期的总记录数，这里设为20000
        pagination_limit = 20000
        
        while True:
            result = index.search("", {
                "filters": "is_verified=1",
                "page": page,
                "hitsPerPage": hits_per_page,
                "paginationLimitedTo": pagination_limit
            })
            
            hits = result["hits"]
            total_pages = result["nbPages"]
            total_hits = result["nbHits"]
            
            print(f"当前第{page+1}页 / 共{total_pages}页，总匹配记录数：{total_hits}")
            
            if not hits:
                break
            
            # 优化文件操作：仅在首次循环时写入表头，避免重复打开文件
            with open("venues.csv", "a", newline='') as file:
                writer = csv.writer(file)
                if page == 0:
                    writer.writerow(["venue_id", "venue_name", "is_verified"])
                for hit in hits:
                    writer.writerow([
                        hit["venue_id"],
                        hit["venue_name"],
                        hit["is_verified"]
                    ])
                    print(f"{hit['venue_id']}: {hit['venue_name']}")
            
            page += 1
            # 提前终止循环，避免无效请求
            if page >= total_pages:
                break

    except Exception as e:
        print(f"错误信息：{str(e)}")

get_all_venues()

解决方案2：使用Algolia Browse API（推荐） #

Browse API是Algolia专门为全量数据遍历设计的接口，没有Search API的分页限制，效率更高：

import csv
# 确保index是已初始化完成的Algolia索引实例

def get_all_venues():
    try:
        # 初始化遍历迭代器，传入过滤条件
        browse_iterator = index.browse({
            "filters": "is_verified=1"
        })
        
        # 一次性打开文件写入所有数据
        with open("venues.csv", "w", newline='') as file:
            writer = csv.writer(file)
            writer.writerow(["venue_id", "venue_name", "is_verified"])
            
            count = 0
            for hit in browse_iterator:
                writer.writerow([
                    hit["venue_id"],
                    hit["venue_name"],
                    hit["is_verified"]
                ])
                print(f"{hit['venue_id']}: {hit['venue_name']}")
                count += 1
            
            print(f"导出完成，共获取{count}条已验证场地记录")

    except Exception as e:
        print(f"错误信息：{str(e)}")

get_all_venues()

额外检查项 #

1. 确认你的Algolia计划支持对应操作：免费版也支持Browse API，但有速率限制；
2. 检查索引配置：在Algolia后台的「索引设置」中，确认maxHitsPerPage值足够大（比如设为1000）；
3. 验证过滤条件：确认is_verified字段的类型是数字而非字符串，避免过滤条件不生效。

内容的提问来源于stack exchange，提问作者Tendekai Muchenje