Unified Search API

Price: Charged according to the corresponding search provider

List of Search API Providers

Provider Name	Notes
tavily	Optional parameter for time filtering (time_range): day, week, month, year, d, w, m, y. Other values are treated as unlimited; Optional parameter for search category (category): general, news. If not provided or other values are passed, it defaults to general.
search1_search	Optional parameter for time filtering (time_range): day, month, year. Other values are treated as unlimited; Optional parameter for search category (category): google, bing, duckduckgo, yahoo, youtube, x, reddit, github, arxiv, wechat, bilibili, imdb, wikipedia. Other values are treated as unlimited; This provider requires the crawl_results field to be set in order to obtain webpage content, but crawl_results will incur additional costs.
search1_news	Optional parameter for time filtering (time_range): day, month, year. Other values are treated as unlimited; Optional parameter for search category (category): google, bing, duckduckgo, yahoo, hackernews. Other values are treated as unlimited; This provider requires the crawl_results field to be set in order to obtain webpage content, but crawl_results will incur additional costs.
bocha	Optional parameter for time filtering (time_range): oneDay, oneWeek, oneMonth, oneYear. In addition to these preset values, it also supports matching date ranges in the format YYYY-MM-DD..YYYY-MM-DD, e.g. (2025-01-01..2025-05-01), and searching for a specific date YYYY-MM-DD, e.g. (2025-01-01). Other formats are treated as unlimited.
exa	Optional parameter for search category (category): company, research paper, news, pdf, github, tweet, personal site, linkedin profile, financial report. Other values are treated as unlimited; For this provider, the time_range parameter is not effective. Instead, use the four fields "startCrawlDate", "endCrawlDate", "startPublishedDate", "endPublishedDate" in ISO8601 format, e.g. (2023-01-01T00:00:00.000Z).
firecrawl	Optional parameter for time filtering (time_range): day, hour, week, month, year. Other values are treated as unlimited.
metaso	Optional parameter for search category (category): "webpage", "document", "scholar", "podcast", "video", "image"; Supports max_results and page parameters (one page = 10 items) to control the number of search results returned, only one of the two can be used; By default, webpage content is not returned. You can set includeRowContent=true in the parameters to enable it, which will incur additional costs.

Request

Header Params

Authorization

string

required

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

query

string

搜索关键词

required

provider

string

搜索接口供应商

required

For specific vendor information, please refer to the table in the documentation.

max_results

integer

最大搜索结果

optional

Default:

include_images

boolean

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

optional

Effective for some vendors

Default:

true

category

string

搜索的内容类别

optional

For the optional parameter range, please refer to the remarks in the vendor list in the documentation.

time_range

string

时间筛选范围

optional

For the optional parameter range, please refer to the remarks in the vendor list in the documentation.

include_domains

网站白名单

optional

There may be cases where the search results are empty, and array batch filtering is supported.

Any of

string

array[string]

exclude_domains

网站黑名单

optional

Support array batch filtering

Any of

string

array[string]

startCrawlDate

string

optional

Only effective when exa is selected as the vendor

endCrawlDate

string

optional

Only effective when exa is selected as the vendor

startPublishedDate

string

optional

Only effective when exa is selected as the vendor

endPublishedDate

string

optional

Only effective when exa is selected as the vendor

crawl_results

integer

抓取网页的完整内容数量

optional

Only effective 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"
    ]
}

List of Search API Providers#

Request

Request samples

Responses

List of Search API Providers