Endpoint di ricerca
Cerca articoli di notizie utilizzando parole chiave, filtri e sintassi di ricerca avanzata.
La funzione di ricerca consente di cercare articoli di notizie nell'intero database utilizzando parole chiave, frasi e operatori di query avanzati. È possibile filtrare i risultati per lingua, paese, categoria, intervallo di date e altro ancora.
https://api.allnewsapi.com/searchParametri di query
Nome | Tipo | Valore predefinito | Descrizione |
|---|---|---|---|
apikeyNecessario | string | — | La tua chiave API per l'autenticazione. Puoi ottenere la tua chiave API dalla dashboard. |
q | string | — | Questo parametro ti consente di recuperare articoli di notizie che corrispondono alla tua parola chiave. Le tue parole chiave aiutano il sistema a trovare gli articoli più adatti a te. Puoi usare le parole insieme agli operatori logici, di cui puoi saperne di più nella Esempi: technology"artificial intelligence"apple AND iphone |
startDate | string | — | Questo parametro consente di filtrare gli articoli in base alla data di pubblicazione. È possibile specificare una data e l'API restituirà solo gli articoli pubblicati a partire da tale data. Esempi: 2024-12-15T17:48:56Z2025-05-20 |
endDate | string | — | Questo parametro consente di filtrare gli articoli in base alla data di pubblicazione. È possibile specificare una data e l'API restituirà solo gli articoli pubblicati in data pari o precedente a tale data. Esempi: 2024-08-14T17:48:56Z2024-01-23 |
content | boolean | false | Questo parametro consente di recuperare il contenuto completo degli articoli. Per impostazione predefinita, il contenuto viene troncato. Impostalo su true per ottenere il contenuto completo. Esempi: truefalse |
lang | string | — | Questo parametro consente di specificare la lingua degli articoli di notizie restituiti dall'API. È possibile combinare più lingue separandole con una virgola. Vedi l'elenco di Esempi: enen,fr,de |
country | string | — | Questo parametro consente di specificare il paese in cui sono stati pubblicati gli articoli di notizie restituiti dall'API. È possibile combinare più paesi separandoli con una virgola. Vedi l'elenco completo di Esempi: usgb,de,fr |
region | string | — | Questo parametro consente di specificare la regione in cui sono stati pubblicati gli articoli di notizie restituiti dall'API. È possibile combinare più regioni separandole con una virgola. Vedi l'elenco completo di Esempi: americasafrica,asia |
category | string | — | Questo parametro consente di filtrare gli articoli di notizie restituiti da una categoria specifica. È possibile combinare più categorie separandole con una virgola. Vedi l'elenco completo di Esempi: financefood,health,hobbies,lifestyle |
max | integer | 5 | Questo parametro consente di specificare il numero di articoli di notizie restituiti dall'API in una singola richiesta. I valori validi sono compresi tra 1 e 100, a seconda dell'abbonamento. Esempi: 1020 |
attributes | string | title,description | Questo parametro consente di selezionare le parti degli articoli di notizie in cui effettuare la ricerca delle parole chiave. I valori validi sono titolo , descrizione e contenuto . È possibile combinare più attributi separandoli con una virgola. Ad esempio, "titolo,descrizione" significa effettuare la ricerca sia nel titolo che nella descrizione. Esempi: titletitle,description,content |
page | integer | 1 | Questo parametro consente di controllare la paginazione dei risultati restituiti dall'API. Ogni pagina visualizza un certo numero di articoli, determinato dal valore di "max". Esempi: 120 |
sortby | string | publishedAt | Questo parametro consente di scegliere come ordinare gli articoli. Sono disponibili due opzioni: Esempi: publishedAtrelevance |
publisher | string | — | Cerca notizie da un editore specifico. Puoi combinare più editori separandoli con una virgola. Esempi: bbc.comforbes.com,cnn.com,bbc.com |
format | string | json | Questo parametro consente di selezionare il formato dei dati restituiti dall'API. È possibile scegliere tra json, csv, or xlsx Esempi: csvxlsx |
ai_sentiment | string | — | Filtra gli articoli in base al valore del sentimento rilevato dall'IA Esempi: positivenegativeneutral |
ai_entity_name | string | — | Filtra gli articoli in base al nome dell'entità estratta (separati da virgola per più elementi) Esempi: AppleMicrosoft,Google |
ai_entity_type | string | — | Filtra gli articoli per tipo di entità , ad esempio PERSONA, ORGANIZZAZIONE, LOCAZIONE (separati da virgola per più elementi). Esempi: ORGPERSON,LOC |
Risposta
L'API restituisce un oggetto JSON contenente un array di articoli di notizie che corrispondono ai criteri di ricerca specificati.
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 |