v1Recursos/Listados publicados/getObtener Índice de Citaciones
Obtener Índice de Citaciones
Cuántos directorios indexan esta ubicación, actual frente a un período anterior.
get
seo:read/api/v1/seo/citation-indexParámetros de consulta
locationIdstringobligatorio
La ubicación a consultar. Búsquelo con GET /api/v1/locations.
clientIdstringopcional
El cliente de la ubicación. Solo necesario para desambiguar cuando su clave está limitada a clientes específicos.
fromstringopcional
Inicio de la ventana (fecha ISO). Por defecto, hace 30 días.
tostringopcional
Fin de la ventana (fecha ISO). Por defecto, ahora.
Respuesta
dataobjectopcional
availablebooleanopcional
Si ya existe una instantánea del índice de citaciones para esta ubicación.
currentobjectopcional
La instantánea más reciente en o antes del fin de la ventana.
percentagenumberopcional
Porcentaje de listados actualmente indexados (0–100), o null.
listingsnumberopcional
Total de listados activos contados en esta instantánea, o null.
indexednumberopcional
De esos, cuántos están indexados, o null.
weekStartstringopcional
La semana de la instantánea, como lunes a las 00:00 UTC.
recordedAtstringopcional
Cuándo se escribió esta instantánea por última vez.
previousobjectopcional
La instantánea más reciente en o antes del inicio de la ventana, para comparación.
percentagenumberopcional
Porcentaje de listados actualmente indexados (0–100), o null.
listingsnumberopcional
Total de listados activos contados en esta instantánea, o null.
indexednumberopcional
De esos, cuántos están indexados, o null.
weekStartstringopcional
La semana de la instantánea, como lunes a las 00:00 UTC.
recordedAtstringopcional
Cuándo se escribió esta instantánea por última vez.
inventoryobjectopcional
Las páginas de listado publicadas hoy para esta ubicación, cada una con su último resultado registrado. No es comparable con las instantáneas semanales de current y previous.
basisstring (current_inventory)obligatorio
Siempre current_inventory: son las páginas de hoy, no una instantánea anterior.
pagesarray of objectobligatorio
Una entrada por cada página de listado publicada.
idstringobligatorio
El id del listado.
publisherIdstringobligatorio
El id del publisher.
namestringobligatorio
El nombre del publisher.
urlstringobligatorio
La URL de la página de listado publicada. Null cuando el enlace guardado no es una URL http(s) absoluta.
statusstring (indexed | not_indexed | pending | not_checked)obligatorio
El último resultado registrado, no una comprobación en directo: indexed, not_indexed, pending o not_checked. pending y not_checked son desconocidos, nunca un resultado negativo.
checkedAtstringobligatorio
Cuándo se registró la última comprobación, o null.
indexedAtstringobligatorio
Cuándo se confirmó que la página estaba indexada, o null. Una página confirmada como indexada no se vuelve a comprobar.
countsobjectobligatorio
Las páginas, contadas por estado.
totalintegerobligatorio
Páginas de listado publicadas.
indexedintegerobligatorio
Páginas que aparecen en la Búsqueda de Google.
notIndexedintegerobligatorio
Páginas con un resultado registrado de no indexada.
pendingintegerobligatorio
Páginas a la espera de un resultado. Desconocido, nunca un resultado negativo.
notCheckedintegerobligatorio
Páginas sin un resultado utilizable todavía. Desconocido, nunca un resultado negativo.
latestEvidenceAtstringobligatorio
Cuándo se registró la comprobación o confirmación más reciente de las páginas, o null. Puede ser una fecha de confirmación sin una comprobación nueva detrás.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/seo/citation-index
Su clave de API
locationId *
clientId
from
to
{
"data": {
"available": true,
"current": {
"percentage": 90.48,
"listings": 42,
"indexed": 38
},
"previous": {
"percentage": 83.33,
"listings": 42,
"indexed": 35
}
}
}