搜索接口专题

接口功能定位

舆情搜索接口是黑料网平台的核心能力之一，专为开发者提供黑料官网相关公开信息的结构化检索服务。该接口支持关键词组合查询、时间范围筛选、来源渠道过滤、情感倾向分类等多维度条件，返回经过合规审核和脱敏处理的信息摘要列表。适用于舆情监测系统、内容聚合平台、数据分析工具等应用场景的核心搜索功能集成。

调用示例

// 基础搜索请求
GET https://couzlzf.cn/api/v1/search
  ?keyword=舆情监测
  &start_date=2024-01-01
  &end_date=2024-06-30
  &source=news,weibo
  &sort=time_desc
  &page=1
  &page_size=20

// 请求头
Authorization: Bearer sk_live_您的密钥
Content-Type: application/json

高级查询技巧

布尔运算查询

支持使用逻辑运算符组合多个关键词，实现精确匹配或排除特定内容。例如查询包含甲且不包含乙的结果。

多来源聚合

通过来源参数指定多个数据渠道，一次请求即可获取跨平台的聚合搜索结果，无需分别调用。

情感筛选

支持按正面、中性、负面三种情感倾向筛选结果，快速定位特定情感方向的舆情信息。

增量同步

通过时间戳参数实现增量数据同步，只获取上次查询之后的新增数据，降低重复传输。

响应字段说明

字段	类型	说明
`id`	字符串	信息条目唯一标识
`title`	字符串	信息标题
`summary`	字符串	内容摘要，最长二百字
`source`	字符串	数据来源渠道
`publish_time`	字符串	原始发布时间
`sentiment`	字符串	情感倾向标注
`heat_score`	数值	热度评分，范围零至一百
`tags`	数组	自动标注的分类标签

常见问题

搜索结果的数据时效性如何？

搜索索引每十五分钟进行一次增量更新，新发布的公开信息通常在十五至三十分钟内可被搜索到。热点事件相关信息会通过加速通道优先入库，延迟可缩短至五分钟以内。

单次搜索最多返回多少条结果？

单次请求最多返回一百条结果。如需获取更多数据，请使用分页参数进行翻页查询。免费版最多可遍历前一千条结果，专业版和企业版无翻页限制。