Ejecutar una búsqueda web y devolver resultados clasificados.
Firecrawl
Search, scrape, map, file parsing and asynchronous crawling.
Ejecutar una búsqueda web y devolver resultados clasificados.
Busca en la web y devuelve resultados clasificados. query es obligatorio; limit define cuántos. Devuelve success, creditsUsed, un id de solicitud y data.web[] con url, title, description y position — solo títulos y fragmentos, sin texto de la página. Recurre a otra cosa cuando: quieras el texto de la página en la misma llamada — searchWeb lo devuelve y responde en un tercio del tiempo; ya conozcas las URLs — post_firecrawl_scrape; quieras relevancia juzgada por significado en lugar de palabras clave — post_exa_search.
Referencia de precios
- Medición: recuento de resultados medidos.
- Estimación de referencia por solicitud: USD 0.002142.
- Base de costo unitario: USD 0.001071.
- Unidad de recurso:
firecrawl_credit. - Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.
- Las bases de costo no determinan el precio final del cliente, incluso cuando son cero.
Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.
- Tipo: stringquerylongitud mín.:1longitud máx.:2000obligatorio
- Tipo: boolean enumenterpriseconstante:falsevalores
- false
- Tipo: integerlimitmín.:1máx.:100
Integer numbers.
- Tipo: array string[] 1…1enumsourcesconstante:[ "web" ]valores
- web
- Tipo: object200
Búsqueda completada correctamente.
- Tipo: integercredits
Used Créditos de Firecrawl consumidos (aproximadamente 2 por cada 10 resultados).
- Tipo: objectdata
- webTipo: array object[]
Resultados de búsqueda web clasificados.
- descriptionTipo: string
Fragmento del resultado.
- titleTipo: string
Título del resultado.
- urlTipo: string
URL del resultado.
- Tipo: booleansuccess
Es true cuando la búsqueda se completó correctamente.
application/json - 400
No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
- 401
Se requiere una clave de API de Felo válida.
- 402
La solicitud no puede continuar porque no se cumple un requisito de facturación.
- 403
La cuenta no tiene permiso para realizar esta operación.
- 429
Se ha alcanzado un límite de solicitudes o de gasto.
- 502
El servicio no pudo completar la solicitud.
- 503
La API o el servicio de facturación no están disponibles temporalmente.
- 504
El servicio agotó el tiempo de espera al procesar la solicitud.
- default
Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor
application/json
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
}