Skip to main content
POST
Run a web search and return ranked results.
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 is cheaper and more precise than searching for them.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string
required

The search query. Must be non-empty and at most 500 characters.

Maximum string length: 500
Example:

"firecrawl web scraping api"

limit
integer
default:10

Maximum number of results to return.

Required range: 1 <= x <= 100

Response

200 - application/json

Search completed successfully.

success
boolean

True when the search succeeded.

data
object
creditsUsed
integer

Firecrawl credits consumed (about 2 per 10 results).