国内博查SearchAPI使用方法，入门指南

简介

博查搜索API是一款面向国内用户的企业级互联网网页搜索引擎接口，旨在为AI应用、RAG应用和AI智能体提供干净、准确、高质量的搜索结果。

使用方法

1. 获取API密钥

首先，您需要在 博查AI开放平台 注册一个账户以获取API密钥。

2. 使用 Web Search API进行基础搜索，搜索全网信息

以下是Python的代码示例：

import requests
import json

url = "https://api.bochaai.com/v1/web-search"
payload = json.dumps({
  "query": "阿里巴巴2024年的ESG报告",
  "summary": True,
  "freshness": "noLimit", #支持 noLimit、oneDay、oneWeek、oneMonth、oneYear
  "count": 10
})
headers = {
  'Authorization': 'Bearer BOCHA-API-KEY',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)

可以通过设置 freshness 参加来调整搜索的时间范围，例如oneDay、oneWeek、oneMonth、oneYear，在搜索实时信息的时候非常有用。

3. 使用 AI Search API进行高级搜索，搜索天气、医疗、百科等。

博查AI Search API在搜索网页信息的基础上，能够返回更多的网页条数（最多25条），同时根据查询关键词的不同，动态返回垂直领域的模态卡（比如天气、百科、日历、火车票、手机、汽车等），例如搜索“北京天气”，会返回类似搜索引擎的“天气卡”，搜索手机时会返回手机参数对比卡等等。同时，可通过answer、stream等参数来控制是否返回大模型总结、是否启用流式输出。

import requests
import json

url = "https://api.bochaai.com/v1/ai-search"
payload = json.dumps({
  "query": "北京天气",
  "answer": False,
  "stream": False
})
headers = {
  'Authorization': 'Bearer BOCHA-API-KEY',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)

可通过响应内容中的 content_type，来判断返回的内容类型。例如：百科、天气等。


可需要博查直接输出大模型的答案，且使用流式输出，则设置为 answer:true， stream: true：

import requests
import json

url = "https://api.bochaai.com/v1/ai-search"
payload = json.dumps({
  "query": "北京天气",
  "answer": True,
  "stream": True
})
headers = {
  'Authorization': 'Bearer BOCHA-API-KEY',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)

所有的搜索结果、模态卡、答案总结、追问问题，都将以“打字机”效果呈现。