Skip to main content
POST
Run a web search and return ranked results.
Search the web and get back ranked results. query is required; limit sets how many. Returns success, creditsUsed, a request id, and data.web[] with url, title, description and positiontitles and snippets only, no page text. Measured at about 15 seconds for 2 results, the slowest of the search tools here. Billed per Firecrawl credit, roughly ceil(limit / 10) * 2. On the AIsa metered profile only the web source is supported; scrapeOptions, enterprise mode and non-web sources are rejected. Reach for something else when: you want the page text in the same call — post_tavily_search returns it and answers in a third of the time; you already know the URLs — post_firecrawl_scrape; you want relevance judged by meaning rather than keywords — post_exa_search.

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).