> ## 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 Search

> Run a web search and get back ranked results for open-web research and agent workflows.

Search the web and get back ranked results. Provide a non-empty `query` (up to 500 characters) and an optional `limit` (default 10, max 100). On the AIsa metered profile only the web source is supported — `scrapeOptions`, enterprise mode, and non-web sources are rejected.

Billing is metered per Firecrawl credit and scales with how many results you request: roughly 2 credits per 10 results (`credits = ceil(limit / 10) * 2`). When you already know the exact pages, [`post_firecrawl-scrape`](/docs/api-reference/search/post_firecrawl-scrape) is cheaper and more precise than searching for them.


## OpenAPI

````yaml openapi/firecrawl.json POST /firecrawl/search
openapi: 3.0.0
info:
  title: Firecrawl API
  version: 1.0.0
  description: >-
    Unified API documentation for Firecrawl endpoints including Scrape, Search,
    Map, Parse, Crawl, and Batch Scrape. Scrape, Search, Map, and Parse are
    synchronous. Crawl and Batch Scrape are asynchronous: the caller submits a
    job and then polls the returned job resource for status and results.


    Billing is metered per Firecrawl credit consumed rather than a flat
    per-request price, so total cost scales with the number of pages, links, or
    results the job produces. Approximate credit usage: Scrape = 1 credit per
    page, Map = 1 credit per page, Search = about 2 credits per 10 results,
    Crawl = 1 credit per page, Batch Scrape = 1 credit per page. The USD rate
    per credit depends on your tier (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: Run a web search and return ranked results.
      description: >-
        Synchronous. Search the web and return ranked results. On the AIsa
        metered profile only the web source is supported: scrapeOptions,
        enterprise mode, and non-web sources are rejected. Billed at roughly 2
        Firecrawl credits per 10 results (credits = ceil(limit / 10) * 2).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: >-
                    The search query. Must be non-empty and at most 500
                    characters.
                  maxLength: 500
                  example: firecrawl web scraping api
                limit:
                  type: integer
                  default: 10
                  minimum: 1
                  maximum: 100
                  description: Maximum number of results to return.
              required:
                - query
      responses:
        '200':
          description: Search completed successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: True when the search succeeded.
                  data:
                    type: object
                    properties:
                      web:
                        type: array
                        description: Ranked web search results.
                        items:
                          type: object
                          properties:
                            title:
                              type: string
                              description: Result title.
                            url:
                              type: string
                              description: Result URL.
                            description:
                              type: string
                              description: Result snippet.
                  creditsUsed:
                    type: integer
                    description: Firecrawl credits consumed (about 2 per 10 results).
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````