API EverySearch Notizie
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
Ricerca di notizie
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 «Notizie» 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 news e inserisci i parametri in params.
- Parametri obbligatori:
- q: Query di ricerca.
- Parametri facoltativi:
- num: Numero di risultati, fino a 10; con valori più alti ne vengono restituiti 10.
- Esempio di corpo della richiesta:
{
"tool": "news",
"params": {
"q": "coffee",
"num": 3
}
}
- 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ì | news | Nome dello strumento, valore fisso. |
q | body.params | string | Sì | - | Query di ricerca. |
num | body.params | integer (1–10) | No | 10 | Numero di risultati, fino a 10; con valori più alti ne vengono restituiti 10. |
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": "news",
"params": {
"q": "coffee",
"num": 3
}
}'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); l'elenco conserva i primi 2. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{ "id": "req_…", "tool": "news", "results": [ { "title": "Coffee calories have jumped nearly 40%. Sugar isn't the biggest culprit", "url": "https://www.sciencedaily.com/releases/2026/10/261021231224.htm", "snippet": "Your morning coffee may be packing more calories than you realize, and sugar isn't the biggest reason. A study of 30000 Americans found that...", "published": "2 days ago" }, { "title": "Two Downtown Gresham coffee shops to close this month", "url": "https://theoutlookonline.com/2026/10/23/two-downtown-gresham-coffee-shops-to-close-this-month/", "snippet": "A pair of coffee shops in Downtown Gresham are both permanently closing this month. Autumn Coffee Roasting is shutting down its location in...", "published": "22 hours ago" } ], "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.