API EverySearch Crawling del sito
POST
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Normale
Ultime 24 ore
Ultimi 30 giorni
Scansiona più pagine di un sito e ne restituisce il testo; indica in linguaggio naturale quali tipi di pagine vuoi
Prezzo $0.69 per 1.000 richieste ($0.000694 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati.
Prompt per l'AI
#Aiutami a scrivere uno script che chiami l'API «Crawling del sito» di EveryInfra.
Contratto dell'API:
- Richiesta: POST https://api.everyinfra.com/api/v1/search con l'header Authorization: Bearer <API Key>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; non inserirla nel codice.
- Nel corpo della richiesta, imposta tool su crawl e inserisci i parametri in params.
- Parametri obbligatori:
- url: L'URL di ingresso del sito da scansionare.
- Parametri facoltativi:
- num: Numero massimo di pagine da scansionare.
- instructions: Una frase che indica quali tipi di pagine vuoi.
- Esempio di corpo della richiesta:
{
"tool": "crawl",
"params": {
"url": "https://www.python.org/",
"num": 2
}
}
- Addebito: Prezzo $0.69 per 1.000 richieste ($0.000694 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati.
- In caso di 422, correggi i parametri seguendo i suggerimenti e i valori consentiti indicati nell'errore. In caso di 429 o 503, attendi il tempo indicato in Retry-After e riprova.
Prima di scrivere il codice, chiedimi quanti elementi devo elaborare e in quale formato salvare i risultati, poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
tool | body | string | Sì | crawl | Nome dello strumento, valore fisso. |
url | body.params | string | Sì | - | L'URL di ingresso del sito da scansionare. |
num | body.params | integer (1–20) | No | 5 | Numero massimo di pagine da scansionare. |
instructions | body.params | string | No | - | Una frase che indica quali tipi di pagine vuoi. |
Esempi di codice
#bash
curl -X POST 'https://api.everyinfra.com/api/v1/search' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"tool": "crawl",
"params": {
"url": "https://www.python.org/",
"num": 2
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#Acquisita il October 24, 2026 at 18:28 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. results e count sono la risposta reale di quella chiamata, da cui sono state rimosse le informazioni personali (nomi, handle, avatar, link ai profili, recapiti). id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{ "id": "req_…", "tool": "crawl", "results": [ { "title": "Welcome to Python.org", "url": "https://www.python.org/", "content": "Notice: This page displays a fallback because interactive scripts did not run. Possible causes include disabled JavaScript or failure to load scripts or stylesheets.\nDonate\n≡ Menu\nSearch This Site\nGO\nA A\nSmaller\nLarger\nReset\nSocialize\nLinkedIn\nMastodon\nChat on IRC\nTwitter\n>_\nLaun…" }, { "title": "Python Software Foundation", "url": "https://www.python.org/psf-landing/", "content": "Notice: This page displays a fallback because interactive scripts did not run. Possible causes include disabled JavaScript or failure to load scripts or stylesheets.\nDonate\n≡ Menu\nSearch This Site\nGO\nA A\nSmaller\nLarger\nReset\nSocialize\nLinkedIn\nMastodon\nChat on IRC\nTwitter\nThe Pyt…" } ], "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.