Semantic SEO API

La API di TrendingOnWiki permette di estrapolare le entità citate nei propri contenuti ed ottenere i relativi riferimenti a Wikidata - la versione linked data di Wikipedia - con cui arricchire i propri dati strutturati schema.org e costruire relazioni semantiche a prova di AI.

Per iniziare

Prima di tutto, occorre recuperare la propria API Key dal pannello di amministrazione del proprio account su TrendingOnWiki. Questa si trova nella pagina "Amministrazione account", nel box "Integrazioni".

Dopodiché: ciascuna chiamata alla Semantic SEO API deve essere accompagnata dall'identificativo della propria Dashboard di riferimento. In questo modo l'API restituirà solo i riferimenti alle entità semanticamente rilevanti per il contesto definito nell'ambito della dashboard stessa, filtrando eventuali altri riferimenti non idonei e ridondanti estrapolati dall'algoritmo interno di Named Entity Recognition (NER). L'identificativo di ciascuna Dashboard è reperibile nel pannello di amministrazione della Dashboard stessa, sotto la voce "Identificativo".

Interrogazione

Per avanzare una interrogazione, invia una richiesta HTTP GET all'endpoint

https://pro.trendingon.wiki/api/keywords

I parametri accettati sono:

key	(obbligatorio) API Key del proprio account, come sopra descritto
dashboard	(obbligatorio) Identificativo della dashboard per la quale contestualizzare i risultati, come sopra descritto
language	Identificativo della lingua usata per il proprio contenuto. Di default viene usata la lingua di riferimento del proprio account (it) ma è possibile utilizzare anche i valori en, fr, de e es
body	(obbligatorio) Il contenuto da cui estrapolare le entità semantiche. Opzionalmente, è possibile veicolare questo parametro direttamente nel body della richiesta GET stessa: particolarmente consigliato quando si trattano testi più lunghi di 2000 caratteri

Esempi

Di seguito, alcuni esempi di riferimento.

cURL CLI

curl "https://trendingon.wiki/api/keywords?dashboard=YOUR_DASHBOARD_ID&key=YOUR_API_KEY&language=it" \
     -X GET \
     --data-binary @your_contents.txt

PHP

$trending_on_wiki_key = 'YOUR_API_KEY';
$dashboard = 'YOUR_DASHBOARD_ID';
$plaintext = 'Your textual contents here.';

$url = 'https://trendingon.wiki/api/keywords?' . http_build_query([
    'dashboard' => $dashboard,
    'key' => $trending_on_wiki_key,
    'language' => 'it',
]);

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($curl, CURLOPT_POSTFIELDS, $plaintext);
curl_setopt($curl, CURLOPT_HEADER, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($curl);
curl_close($curl);

$response = json_decode($res);
print_r($response);

Risposta

La risposta ritornata dall'API è formattata in JSON, e contiene informazioni strutturate che possono essere direttamente aggiunte al campo about dell'entità JSON-LD serializzata nella propria pagina web.

L'attributo sameAs rappresenta l'effettiva relazione semantica con la base dati di Wikidata.

[{
    "name": "Wikidata",
    "sameAs": "http://www.wikidata.org/entity/Q2013"
}, {
    "name": "Application programming interface",
    "sameAs": "http://www.wikidata.org/entity/Q165194"
}, {
    "name": "Ottimizzazione per i motori di ricerca",
    "sameAs": "http:\/\/www.wikidata.org\/entity\/Q180711"
}]

Interessante?
Scrivi a info@trendingon.wiki per maggiori informazioni
o per una presentazione gratuita.