Domande frequenti

È davvero gratuito?

Il piano gratuito è. Ottieni una chiave ed esegui questo:

curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=test&size=1"

Il piano gratuito prevede 3,000 richieste al mese e 120 al minuto. Le chiavi sono obbligatorie a partire dal 1 novembre 2026.

Qual è il lato oscuro?

Tre, detto chiaramente. La finestra è di 90 giorni, non di anni. Non c'è un SLA. E non ci sono analisi del sentiment o estrazione di entità: i concorrenti le fatturano e noi non le abbiamo ancora. L'elenco completo dei punti in cui siamo inferiori.

Posso usarlo a scopo commerciale?

Sì, senza upgrade e senza bisogno di autorizzazione. Tieni presente che NewsAPI.org e GNews vietano l'uso commerciale nei loro piani gratuiti, indipendentemente dal volume: verifica cosa accetti altrove.

Indica il link all'articolo originale url quando mostri il contenuto a una persona. È il lavoro del editore.

Da dove provengono i dati?

Archivi di notizie pubblici su larga scala: raccolte complete di pagine web già indicizzate, rilasciate in modo continuo. Elaboriamo ogni rilascio e indicizziamo il risultato. Maggiori informazioni sulle fonti.

Quanto è recente e come posso verificarlo?

Il corpus viene aggiornato continuamente durante tutto l'arco della giornata. Ogni batch di ingestione viene pubblicato negli snapshot con nome del file, numero di articoli e timestamp, mentre stato e /health mostrano lo stato live del servizio. Puoi quindi verificare l'aggiornamento dei dati autonomamente, senza affidarti a un badge di marketing che promette il real-time.

Perché solo 90 giorni?

È ciò che rientra nello spazio che possiamo dedicare senza trasformarlo in un centro di costi. Il compromesso ti ha garantito il piano gratuito. Se ti serve l'archivio, acquista l'archivio: NewsData.io e Perigon offrono anni di archivio.

Ottengo il testo completo dell'articolo?

Sì, con full_text=true, senza costi aggiuntivi. Ogni concorrente blocca i corpi degli articoli dietro un piano a pagamento. I corpi sono grandi: verifica i costi dei token prima di richiederne cento.

Quali editori sono coperti?

L'indice corrente include materiale da oltre 25,000 editori, con diverse migliaia attivi in una giornata tipica. La copertura riflette ciò che gli archivi pubblici e i nostri lettori di feed hanno catturato; è ampia ma non costituisce un elenco garantito per ogni singolo editore. Usa la directory degli editori e il dettaglio per origine per verificare un hostname prima di sviluppare su di essa.

Perché il campo paese a volte è errato?

Poiché è inferito, e ti diciamo come. country_source indica se proviene da un dominio con codice paese (affidabile), dal markup dell'editore (affidabile), da un tag locale (solitamente corretto) o da un'impostazione predefinita en-US (non affidabile). Per un'analisi a livello di paese aggiungi strict_country=true. Spiegazione completa.

Posso ottenere i risultati per rilevanza invece che per data?

Sì: sort=relevance. Il valore predefinito è date perché la maggior parte degli utenti vuole i risultati più recenti. Usa sort=crawled durante il polling: gli editori indicano date di pubblicazione retroattive, mentre il tempo di crawl non si sposta mai all'indietro.

Come recupero un'intera giornata?

Fetta per intervallo temporale. Il limite massimo dell'offset è 9,900 e un giorno contiene circa 110,000 articoli. Il ciclo è gestito dalla paginazione.

Esiste un server MCP?

Sì. Il server è disponibile su /mcp e utilizza Streamable HTTP con la tua chiave API. Espone strumenti curati per la ricerca di notizie, le tendenze, gli editori e i mercati, oltre a strumenti generati dallo schema OpenAPI. /mcp.json restituisce il catalogo degli strumenti leggibile dalla macchina, e la guida MCP mostra la configurazione del client.

Avete un SDK?

No, e non ne hai bisogno. Sono quattro endpoint GET che restituiscono JSON. Qualsiasi client HTTP in qualsiasi linguaggio funge da SDK. Esempi nella guida introduttiva.

Cosa devo fare se ho bisogno di più del piano gratuito?

Vedi piani, o chiedi. Se stai eseguendo un'esportazione massiva, esiste un metodo migliore rispetto a 100,000 richieste HTTP.

Mi tracciate?

Conserviamo solo ciò che è necessario per il funzionamento del servizio: il tuo account, l'utilizzo per chiave API e i log del server. Nessuna rete pubblicitaria, nessun broker di dati. Privacy completa.

Sono un editore e voglio che il mio sito venga rimosso.

Scrivici e sarà fatto, senza discussioni. Dettagli.