Lunes, 31 de enero del 2022
Hoy presentamos la nueva API URL Inspection de Google Search Console, que ofrece acceso programático a datos a nivel de URL de las propiedades que gestionas en Search Console.
Las APIs de Search Console son una forma de acceder a datos ajenos a Search Console a través de aplicaciones y productos externos. Los desarrolladores y las herramientas de SEO ya usan las APIs para crear soluciones personalizadas con las que ver, añadir o retirar propiedades y sitemaps, así como para ejecutar consultas avanzadas en los datos de rendimiento de la Búsqueda.
Con la nueva API URL Inspection, ofrecemos a los desarrolladores una herramienta más para depurar y optimizar sus páginas. Puedes solicitar los datos que tiene Search Console sobre la versión indexada de una URL. La API devolverá la información indexada que esté disponible en ese momento en la herramienta de inspección de URLs.
Usar la nueva API
Para aprender a usar la nueva API, consulta la documentación para desarrolladores sobre APIs. Entre los parámetros de solicitud se incluyen la URL que quieras inspeccionar y la URL de la propiedad tal como esté definida en Search Console.
La respuesta incluye resultados de análisis que contienen información de Search Console, como el estado de indexación, AMP, resultados enriquecidos y usabilidad móvil. Para obtener más información, consulta la lista de parámetros y la explicación de los resultados de URLs indexadas.
Una vez que realices la llamada a la API, obtendrás una respuesta con todos los resultados relevantes o un mensaje de error si la solicitud falla. Si falta algún resultado de análisis concreto en la respuesta, significa que ese análisis no estaba disponible en la URL inspeccionada. A continuación, te mostramos un ejemplo de la respuesta que puedes obtener de la API.
{
"inspectionResult": {
"inspectionResultLink": "https://search.google.com/search-console/inspect?resource_id=https://developers.google.com/search/&id=odaUL5Dqq3q8n0EicQzawg&utm_medium=link",
"indexStatusResult": {
"verdict": "PASS",
"coverageState": "Indexed, not submitted in sitemap",
"robotsTxtState": "ALLOWED",
"indexingState": "INDEXING_ALLOWED",
"lastCrawlTime": "2022-01-31T08:39:51Z",
"pageFetchState": "SUCCESSFUL",
"googleCanonical": "https://developers.google.com/search/help/site-appearance-faq",
"userCanonical": "https://developers.google.com/search/help/site-appearance-faq",
"referringUrls": [
"https://developers.google.com/search/updates",
"https://developers.google.com/search/help/crawling-index-faq"
],
"crawledAs": "MOBILE"
},
"mobileUsabilityResult": {
"verdict": "PASS"
},
"richResultsResult": {
"verdict": "PASS",
"detectedItems": [
{
"richResultType": "Breadcrumbs",
"items": [
{
"name": "Unnamed item"
}
]
},
{
"richResultType": "FAQ",
"items": [
{
"name": "Unnamed item"
}
]
}
]
}
}
}
Posibles casos prácticos
Durante el desarrollo de la nueva API, hemos consultado a varios especialistas en SEO y editores sobre cómo aprovecharían la API para crear soluciones con estos datos. Estos son algunos de los casos prácticos más destacados:
- Las herramientas y las agencias de SEO pueden ofrecer supervisión continua de páginas importantes y opciones de depuración de páginas concretas. Por ejemplo, comprobar si hay diferencias entre las páginas canónicas declaradas por el usuario y las seleccionadas por Google, o depurar problemas de datos estructurados en un grupo de páginas.
- Los desarrolladores de CMS y complementos pueden añadir información valiosa a nivel de página o plantilla y hacer comprobaciones continuas en páginas ya creadas. Por ejemplo, monitorizar los cambios a lo largo del tiempo en páginas clave para diagnosticar problemas y ayudar a priorizar las correcciones.
Límites de uso
Puedes consultar una descripción más detallada de los límites de uso de APIs de Search Console en la documentación para desarrolladores. En concreto, con respecto a la API URL Inspection, la cuota se aplica por cada propiedad de sitio web de Search Console (llamadas que hacen consultas en el mismo sitio):
- 2000 consultas al día
- 600 consultas por minuto
Comentarios
Creemos que esta API ofrecerá al ecosistema nuevas oportunidades para innovar con los datos de la Búsqueda de Google. Siempre nos entusiasma ver las soluciones que crean los desarrolladores y los especialistas en SEO a partir de las APIs de Search Console.
Si tienes alguna duda o comentario, ponte en contacto con nosotros a través de Twitter o publica una pregunta en la comunidad del Centro de la Búsqueda.