API de SEO Semántico

La API de TrendingOnWiki permite extraer las entidades mencionadas en tus contenidos y obtener las referencias correspondientes a Wikidata - la versión linked data de Wikipedia - con la que puedes enriquecer tus datos estructurados schema.org y construir relaciones semánticas a prueba de IA.

Para empezar

Primero, necesitas recuperar tu clave API del panel de administración de tu cuenta en TrendingOnWiki. La encontrarás en la página "Administración de la cuenta", en el cuadro "Integraciones".

Luego: cada llamada a la API de SEO Semántico debe ir acompañada del identificador de tu Dashboard de referencia. De esta manera, la API solo devolverá las referencias a las entidades semánticamente relevantes para el contexto definido en el ámbito de la propia dashboard, filtrando cualquier otra referencia no adecuada o redundante extraída del algoritmo interno de Named Entity Recognition (NER). El identificador de cada Dashboard se encuentra en el panel de administración de la misma, bajo el título "Identificador".

Consulta

Para realizar una consulta, envía una solicitud HTTP GET al endpoint

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

Los parámetros aceptados son:

key	(obligatorio) Clave API de tu cuenta, como se describe arriba
dashboard	(obligatorio) Identificador de la dashboard para la que contextualizar los resultados, como se describe arriba
language	Identificador del idioma utilizado para tu contenido. Por defecto, se utiliza el idioma de referencia de tu cuenta (es), pero también puedes utilizar los valores en, fr, de y it
body	(obligatorio) El contenido del que quieres extraer las entidades semánticas. Opcionalmente, puedes enviar este parámetro directamente en el cuerpo de la solicitud GET: especialmente recomendable cuando se trata de textos de más de 2000 caracteres

Ejemplos

A continuación, algunos ejemplos de referencia.

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);

Respuesta

La respuesta devuelta por la API está formateada en JSON y contiene información estructurada que puede añadirse directamente al campo about de la entidad JSON-LD serializada en tu página web.

El atributo sameAs representa la relación semántica real con la base de datos de 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"
}]

¿Interesante?
Escríbenos a info@trendingon.wiki para más información
o para una presentación gratuita.