Unified Search API

Price：Charges based on the corresponding search provider

Search Interface Provider List

Supplier Name	Remarks
tavily	Time filter range (time_range) optional parameters: day, week, month, year, d, w, m, y. Passing other values is considered unrestricted; Search category (category) optional parameters: general, news. Not passing or passing other values is considered general
search1_search	Time filter range (time_range) optional parameters: day, month, year. Passing other values is considered unrestricted; Search category (category) optional parameters: google, bing, duckduckgo, yahoo, youtube, x, reddit, github, arxiv, wechat, bilibili, imdb, wikipedia. Passing other values is considered unrestricted; This supplier requires the crawl_results field to be passed to access web content, which incurs additional costs
search1_news	Time filter range (time_range) optional parameters: day, month, year. Passing other values is considered unrestricted; Search category (category) optional parameters: google, bing, duckduckgo, yahoo, hackernews. Passing other values is considered unrestricted; This supplier requires the crawl_results field to be passed to access web content, which incurs additional costs
bocha	Time filter range (time_range) optional parameters: oneDay, oneWeek, oneMonth, oneYear. In addition to using these preset values, it also supports matching date ranges YYYY-MM-DD..YYYY-MM-DD, eg(2025-01-01..2025-05-01), and searching for specific dates YYYY-MM-DD, eg(2025-01-01). Passing other formats of values is considered unrestricted;
exa	Search category (category) optional parameters: company, research paper, news, pdf, github, tweet, personal site, linkedin profile, financial report. Passing other values is considered unrestricted; For this supplier, the time_range parameter is not effective and is controlled by the "startCrawlDate", "endCrawlDate", "startPublishedDate", "endPublishedDate" four fields, with data format as iso8601 time format, eg(2023-01-01T00:00:00.000Z).
firecrawl	Time filter range (time_range) optional parameters: day, hour, week, month, year. Passing other values is considered unrestricted;

Request

Header Params

Authorization

string

required

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

query

string

搜索关键词

required

provider

string

搜索接口供应商

required

See the table in the documentation for detailed supplier information

max_results

integer

最大搜索结果

optional

Default:

include_images

boolean

搜索结果是否包含图片信息

optional

Only some suppliers take effect

Default:

true

category

string

搜索的内容类别

optional

The optional parameter range is explained in the remarks section of the supplier list in the documentation

time_range

string

时间筛选范围

optional

The optional parameter range is explained in the remarks section of the supplier list in the documentation

include_domains

网站白名单

optional

Search results may sometimes be empty, and array batch filtering is supported

Any of

string

array[string]

exclude_domains

网站黑名单

optional

Array batch filtering is supported

Any of

string

array[string]

startCrawlDate

string

optional

This only takes effect when “exa” is selected as the supplier.

endCrawlDate

string

optional

This only takes effect when “exa” is selected as the supplier.

startPublishedDate

string

optional

This only takes effect when “exa” is selected as the supplier.

endPublishedDate

string

optional

This only takes effect when “exa” is selected as the supplier.

crawl_results

integer

抓取网页的完整内容数量

optional

This only takes effect when “search1_search” or “search1_news” is selected

Example

{
  "query": "302ai",
  "provider": "tavily",
  "max_results": 6
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Body

search_results

array [object {7}]

整合成统一字段的搜索结果列表

required

url

string

网页链接

required

title

string

网页标题

required

description

string

内容描述(摘要)

required

content

string

网页完整内容

required

published_at

string

发布时间

required

Some suppliers do not return this field in the search results, so the result displays as an empty string

summary

string

网页内容总结

required

Some suppliers support web content summarization

images

array[string]

图片列表

required

For some suppliers, image information is included in each search result item

data

object

搜索接口的原始响应

required

images

array[string]

图片结果

required

For some suppliers, image information is placed at the outermost level

Example

{
  "search_results": [
    {
      "url": "https://github.com/302ai",
      "title": "302.AI - GitHub",
      "description": "",
      "content": "302.AI is a verified GitHub account that provides various AI tools and applications for online and offline use. You can explore 47 open-source projects covering different fields, such as image, video, text, voice, and more.",
      "published_at": "",
      "summary": "",
      "images": []
    },
    {
      "url": "https://github.com/302ai/ai-sdk",
      "title": "302ai/ai-sdk: 302's AI SDK for everyone - GitHub",
      "description": "",
      "content": "302 AI SDK is an official provider SDK for 302AI that integrates with Vercel AI SDK. It offers access to a wide range of AI models for text, image and embedding generation, with a unified, type-safe API and full TypeScript support.",
      "published_at": "",
      "summary": "",
      "images": []
    },
    {
      "url": "https://302.ai/",
      "title": "【官网】302.ai - 企业级ai应用平台，按用量付费，开箱即用，开源生态",
      "description": "",
      "content": "302.AI是一个提供各种AI功能的平台，包括聊天机器人、绘画机器人、知识库机器人等，支持多种AI模型，如OpenAI、Anthropic、Google等。用户可以一键部署、一键分享、一人管理AI应用，享受按用量付费的优惠，参与开源生态的贡献。",
      "published_at": "",
      "summary": "",
      "images": []
    },
    {
      "url": "https://wiki.eryajf.net/pages/831959/",
      "title": "302ai，包揽你的ai需求 | 二丫讲梵",
      "description": "",
      "content": "302AI提供了机器人、工具和API三大功能，让用户可以按需调用各种大模型的能力，无需月费，无需席位费。平台持续投入技术，开源代码，支持二次开发和私有化部署。",
      "published_at": "",
      "summary": "",
      "images": []
    },
    {
      "url": "https://dash.302.ai/login",
      "title": "Dashboard - 302.AI",
      "description": "",
      "content": "Secure login to 302.AI's enterprise AI application platform.",
      "published_at": "",
      "summary": "",
      "images": []
    },
    {
      "url": "https://api.302.ai/",
      "title": "302 Ai",
      "description": "",
      "content": "Directly use all open-source models of silicon-based flow at 302.AI.",
      "published_at": "",
      "summary": "",
      "images": []
    }
  ],
  "data": {
    "query": "302ai",
    "follow_up_questions": null,
    "answer": null,
    "images": [
      "http://www.aixuanfeng.com/wp-content/uploads/2024/05/捕获-60.png",
      "https://302.ai/_astro/bg.93ff69da_78kcK.webp",
      "https://302.ai/_image?href=/_astro/logo.33ec793a.png&f=webp",
      "https://assets.waytoagi.com/usercontent/2024_11_12_14_43_58_493243ae65.png",
      "https://302.ai/_astro/api.9a3c09ef_Z7Ekmv.webp"
    ],
    "results": [
      {
        "title": "302.AI - GitHub",
        "url": "https://github.com/302ai",
        "content": "302.AI is a verified GitHub account that provides various AI tools and applications for online and offline use. You can explore 47 open-source projects covering different fields, such as image, video, text, voice, and more.",
        "score": 0.9123193,
        "raw_content": null
      },
      {
        "title": "302ai/ai-sdk: 302's AI SDK for everyone - GitHub",
        "url": "https://github.com/302ai/ai-sdk",
        "content": "302 AI SDK is an official provider SDK for 302AI that integrates with Vercel AI SDK. It offers access to a wide range of AI models for text, image and embedding generation, with a unified, type-safe API and full TypeScript support.",
        "score": 0.8952393,
        "raw_content": null
      },
      {
        "title": "【官网】302.ai - 企业级ai应用平台，按用量付费，开箱即用，开源生态",
        "url": "https://302.ai/",
        "content": "302.AI是一个提供各种AI功能的平台，包括聊天机器人、绘画机器人、知识库机器人等，支持多种AI模型，如OpenAI、Anthropic、Google等。用户可以一键部署、一键分享、一人管理AI应用，享受按用量付费的优惠，参与开源生态的贡献。",
        "score": 0.8706085,
        "raw_content": null
      },
      {
        "title": "302ai，包揽你的ai需求 | 二丫讲梵",
        "url": "https://wiki.eryajf.net/pages/831959/",
        "content": "302AI提供了机器人、工具和API三大功能，让用户可以按需调用各种大模型的能力，无需月费，无需席位费。平台持续投入技术，开源代码，支持二次开发和私有化部署。",
        "score": 0.82186085,
        "raw_content": null
      },
      {
        "title": "Dashboard - 302.AI",
        "url": "https://dash.302.ai/login",
        "content": "Secure login to 302.AI's enterprise AI application platform.",
        "score": 0.6625569,
        "raw_content": null
      },
      {
        "title": "302 Ai",
        "url": "https://api.302.ai/",
        "content": "Directly use all open-source models of silicon-based flow at 302.AI.",
        "score": 0.6530611,
        "raw_content": null
      }
    ],
    "response_time": 2.37
  },
  "images": [
    "http://www.aixuanfeng.com/wp-content/uploads/2024/05/捕获-60.png",
    "https://302.ai/_astro/bg.93ff69da_78kcK.webp",
    "https://302.ai/_image?href=/_astro/logo.33ec793a.png&f=webp",
    "https://assets.waytoagi.com/usercontent/2024_11_12_14_43_58_493243ae65.png",
    "https://302.ai/_astro/api.9a3c09ef_Z7Ekmv.webp"
  ]
}

Search Interface Provider List#

Request

Request samples

Responses

Search Interface Provider List