Iniziare
Scopri come effettuare la tua prima richiesta API e iniziare a recuperare i dati delle notizie.
Benvenuti su AllNewsAPI! Questa guida vi illustrerà le nozioni di base sull'utilizzo della nostra API per recuperare articoli di notizie da tutto il mondo.
1. Ottieni la tua chiave API
Innanzitutto, avrai bisogno di una chiave API per autenticare le tue richieste. Registrati per un account gratuito e ricevi subito la tua chiave API.
2. Fai la tua prima richiesta
Una volta ottenuta la chiave API, puoi effettuare la tua prima richiesta API. Ecco un semplice esempio per cercare articoli di notizie:
3. Comprendere la risposta
L'API restituisce una risposta JSON contenente un array di articoli di notizie. Ogni articolo include le seguenti proprietà:
Nome | Tipo | Valore predefinito | Descrizione |
|---|---|---|---|
totalArticles | integer | — | Il numero totale di articoli corrispondenti alla tua query di ricerca |
currentPage | integer | — | Il numero di pagina corrente nei risultati impaginati |
nextPage | integer | — | Il numero della pagina successiva (nullo se si trova all'ultima pagina) |
articles | array | — | Una serie di oggetti articolo corrispondenti ai criteri di ricerca |
articles[].title | string | — | Il titolo dell'articolo di notizie |
articles[].description | string | — | La descrizione o il riassunto dell'articolo di notizie |
articles[].category | string | — | La categoria a cui appartiene l'articolo |
articles[].content | string | — | Il contenuto completo dell'articolo (contenuto premium) |
articles[].country | string | — | Il codice del paese in cui è stato pubblicato l'articolo (ISO 3166-1 alpha-2) |
articles[].region | string | — | La regione geografica in cui è stato pubblicato l'articolo |
articles[].lang | string | — | Il codice linguistico dell'articolo (ISO 639-1) |
articles[].authors | array | — | Elenco dei nomi degli autori degli articoli |
articles[].ai_sentiment | string | — | Etichetta di sentimento rilevata dall'IA (positiva, negativa o neutra). Solo per piani a pagamento. |
articles[].ai_sentiment_scores | object | — | Oggetto contenente i punteggi di affidabilità per ciascuna categoria di sentiment. Solo per piani a pagamento. |
articles[].ai_entities | array | — | Array di entità denominate estratte con campi nome e tipo. Solo per piani a pagamento. |
articles[].ai_summary | string | — | Riassunto del contenuto dell'articolo generato dall'intelligenza artificiale. Disponibile solo con i piani a pagamento. |
articles[].url | string | — | L'URL diretto all'articolo originale |
articles[].image | string | — | L'URL dell'immagine principale o della miniatura dell'articolo |
articles[].publishedAt | string | — | Data e ora di pubblicazione dell'articolo in formato ISO 8601 (UTC) |
articles[].source.name | string | — | Il nome dell'editore o della fonte della notizia |
articles[].source.url | string | — | L'URL della homepage della fonte di notizie |
Il piano gratuito include l'accesso a notizie in tempo reale, fino a 50 richieste al giorno e 7 giorni di dati storici. Non è richiesta alcuna carta di credito!
Prossimi passi
Ora che hai effettuato la tua prima richiesta, consulta queste guide per saperne di più: