> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Firecrawl 搜索

> 执行网页搜索并返回排序结果，适用于开放网页研究和 agent 工作流。

搜索网页并返回排序结果。需提供非空的 `query`（最长 500 字符）和可选的 `limit`（默认 10，最大 100）。在 AIsa 计量模式下仅支持 web 来源——`scrapeOptions`、企业模式和非 web 来源都会被拒绝。

计费按 Firecrawl credit 计量，并随请求的结果数量增长：约每 10 条结果 2 credits（`credits = ceil(limit / 10) * 2`）。如果你已经知道确切页面，[`post_firecrawl-scrape`](/docs/zh/api-reference/search/post_firecrawl-scrape) 比搜索更便宜也更精确。


## OpenAPI

````yaml openapi/zh/firecrawl.json POST /firecrawl/search
openapi: 3.0.0
info:
  title: Firecrawl API
  version: 1.0.0
  description: >-
    Firecrawl 各 endpoint 的统一 API 文档，包括 Scrape、Search、Map、Parse、Crawl 和 Batch
    Scrape。Scrape、Search、Map 和 Parse 是同步接口。Crawl 和 Batch Scrape
    是异步接口：调用方提交任务，然后轮询返回的任务资源以获取状态和结果。


    计费按消耗的 Firecrawl credit 计量，而不是按请求固定收费，因此总费用随任务产生的页面、链接或结果数量增长。大致 credit
    消耗：Scrape = 每页 1 credit，Map = 每页 1 credit，Search = 每 10 条结果约 2 credits，Crawl
    = 每页 1 credit，Batch Scrape = 每页 1 credit。每个 credit 对应的美元费率取决于你的等级（normal
    $0.005，vip $0.004，svip $0.0034）。
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - bearerAuth: []
paths:
  /firecrawl/search:
    post:
      tags:
        - https://docs.firecrawl.dev/api-reference/endpoint/search
      summary: 执行网页搜索并返回排序结果。
      description: >-
        同步接口。搜索网页并返回排序结果。在 AIsa 计量模式下仅支持 web 来源：scrapeOptions、企业模式和非 web
        来源都会被拒绝。计费约为每 10 条结果 2 个 Firecrawl credits（credits = ceil(limit / 10) *
        2）。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: 搜索查询词。必须非空，且不超过 500 字符。
                  maxLength: 500
                  example: firecrawl web scraping api
                limit:
                  type: integer
                  default: 10
                  minimum: 1
                  maximum: 100
                  description: 返回结果数量的上限。
              required:
                - query
      responses:
        '200':
          description: 搜索成功完成。
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 搜索成功时为 true。
                  data:
                    type: object
                    properties:
                      web:
                        type: array
                        description: 排序后的网页搜索结果。
                        items:
                          type: object
                          properties:
                            title:
                              type: string
                              description: 结果标题。
                            url:
                              type: string
                              description: 结果 URL。
                            description:
                              type: string
                              description: 结果摘要片段。
                  creditsUsed:
                    type: integer
                    description: 消耗的 Firecrawl credits（约每 10 条结果 2 个）。
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````