Esegui una ricerca web e restituisci risultati classificati.
Firecrawl
Search, scrape, map, file parsing and asynchronous crawling.
Esegui una ricerca web e restituisci risultati classificati.
Cerca sul web e ottieni risultati classificati. query è obbligatorio; limit stabilisce quanti. Restituisce success, creditsUsed, un id richiesta e data.web[] con url, title, description e position — solo titoli e snippet, nessun testo di pagina. Scegli qualcos'altro quando: vuoi il testo della pagina nella stessa chiamata — searchWeb lo restituisce e risponde in un terzo del tempo; conosci già gli URL — post_firecrawl_scrape; vuoi che la pertinenza sia giudicata per significato anziché per parole chiave — post_exa_search.
Riferimento prezzi
- Misurazione: numero di risultati misurato.
- Stima di riferimento per richiesta: USD 0.002142.
- Base di costo unitario: USD 0.001071.
- Unità di risorsa:
firecrawl_credit. - Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.
- Le basi di costo non determinano il prezzo finale per il cliente, anche quando sono zero.
Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
- Tipo: stringquerylunghezza minima:1lunghezza massima:2000obbligatorio
- Tipo: boolean enumenterpriseconst:falsevalori
- false
- Tipo: integerlimitmin:1max:100
Integer numbers.
- Tipo: array string[] 1…1enumsourcesconst:[ "web" ]valori
- web
- Tipo: object200
Ricerca completata correttamente.
- Tipo: integercredits
Used Crediti Firecrawl consumati (circa 2 ogni 10 risultati).
- Tipo: objectdata
- webTipo: array object[]
Risultati ordinati della ricerca web.
- descriptionTipo: string
Snippet del risultato.
- titleTipo: string
Titolo del risultato.
- urlTipo: string
URL del risultato.
- Tipo: booleansuccess
Vero se la ricerca è riuscita.
application/json - 400
Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
- 401
È richiesta una chiave API Felo valida.
- 402
Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
- 403
L'account non è autorizzato a eseguire questa operazione.
- 429
È stato raggiunto un limite di richieste o di spesa.
- 502
Il servizio non è riuscito a completare la richiesta.
- 503
L'API o il servizio di fatturazione è temporaneamente non disponibile.
- 504
Si è verificato un timeout durante l'elaborazione della richiesta.
- default
Risposta di errore; le risposte passthrough upstream possono usare formati del provider
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
}