数据 API / Firecrawl / Search

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 position — titles and snippets only, no page text. Reach for something else when: you want the page text in the same call — searchWeb 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.

参数

没有路径、查询或请求头参数。

请求体

querystring必填
The search query. Must be non-empty and at most 500 characters.
limitinteger可选
Maximum number of results to return.

请求示例

curl -X POST "https://openapi.felo.ai/v1/beta/firecrawl/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "<string>",
  "limit": 0
}'

响应

响应字段

successboolean可选
True when the search succeeded.
dataobject可选
webobject[]可选
Ranked web search results.
titlestring可选
Result title.
urlstring可选
Result URL.
descriptionstring可选
Result snippet.
creditsUsedinteger可选
Firecrawl credits consumed (about 2 per 10 results).