Firecrawl
Search, scrape, map, file parsing and asynchronous crawling.
Firecrawl 操作
执行网络搜索并返回按排名排列的结果。
搜索网络并返回按排名排列的结果。query 为必填;limit 设置数量。返回 success、creditsUsed、请求 id,以及包含 url、title、description 和 position 的 data.web[]——仅标题和摘要,不含页面文本。以下情况请改用其他工具:希望同一次调用拿到页面文本——searchWeb 会返回文本,且耗时只有三分之一;已知 URL——post_firecrawl_scrape;希望按语义而非关键词判断相关性——post_exa_search。
计费参考
- 计量方式:按结果数量计量。
- 参考请求估算:0.002142 美元。
- 单位成本基准:0.001071 美元。
- 资源单位:
firecrawl_credit。 - 参考客户倍率:1.0。不得对已结算的客户金额再次应用。
- 成本基准不构成最终客户价格,即使为零也不例外。
仅供参考的元数据,不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
请求体
必填
application/json
- 类型: stringquery最小长度:1最大长度:2000必填
- 类型: boolean 枚举enterprise常量:false值
- false
- 类型: integerlimit最小值:1最大值:100
Integer numbers.
- 类型: array string[] 1…1枚举sources常量:[ "web" ]值
- web
响应
- 类型: object200
搜索成功完成。
- 类型: integercredits
Used 消耗的 Firecrawl 额度(每 10 条结果约 2 个)。
- 类型: objectdata
- web类型: array object[]
排序后的网页搜索结果。
- description类型: string
结果摘要。
- title类型: string
结果标题。
- url类型: string
结果 URL。
- 类型: booleansuccess
search 成功时为 true。
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求,请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应;上游透传响应可能采用提供方格式
application/json
Request Example for post/v1/beta/firecrawl/search
curl https://openapi.felo.ai/v1/beta/firecrawl/search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"enterprise": false,
"limit": 10,
"query": "nike",
"sources": [
"web"
]
}'
{
"success": true,
"data": {
"web": [
{
"title": "string",
"url": "string",
"description": "string"
}
]
},
"creditsUsed": 1
}