Le damos la bienvenida a la nueva API de inspección de URL de Search Console

Lunes, 31 de enero de 2022

Hoy lanzamos la nueva API de inspección de URL de Google Search Console, que brinda acceso programático a los datos a nivel de URL para las propiedades que administras en Search Console.

Las API de Search Console permiten acceder a los datos fuera de Search Console mediante aplicaciones y productos externos. Las herramientas para desarrolladores y SEO ya usan las API para compilar soluciones personalizadas a fin de ver, agregar o quitar propiedades y mapas del sitio, y ejecutar búsquedas avanzadas sobre los datos de rendimiento de la Búsqueda.

Con la nueva API de inspección de URLs, proporcionamos una nueva herramienta para que los desarrolladores depuren y optimicen sus páginas. Puedes solicitar que los datos tengan Search Console sobre la versión indexada de una URL; la API mostrará la información indexada que está disponible actualmente en la Herramienta de inspección de URL.

Usa la API nueva

Si deseas obtener información para usar la nueva API, consulta la documentación para desarrolladores de la API. Los parámetros de solicitud incluyen la URL que deseas inspeccionar y la URL de la propiedad, como se define en Search Console.

En la respuesta, se incluyen resultados de análisis con información de Search Console, como el estado de la indexación, las AMP, los resultados enriquecidos y la usabilidad para dispositivos móviles. Para obtener más detalles, lee la lista de parámetros y la Explicación de los resultados de URLs indexadas.

Una vez que realices la llamada a la API, recibirás una respuesta con todos los resultados relevantes, o bien un mensaje de error si falla la solicitud. Si falta un resultado de análisis específico en la respuesta, significa que el análisis no estaba disponible para la URL inspeccionada. Este es un ejemplo de la respuesta que obtendrás 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 de uso

Mientras creamos la API nueva, consultamos a varios SEO y publicadores con respecto a cómo usarían la API para crear soluciones con estos datos. Estos son algunos de los casos prácticos que se destacan:

  • Las herramientas y agencias de SEO pueden ofrecer supervisión continua de las páginas importantes y de las opciones de depuración de una sola página. Por ejemplo, verifican si hay diferencias entre las páginas canónicas declaradas por el usuario y las seleccionadas por Google, y depuran problemas de datos estructurados de un grupo de páginas.
  • Los desarrolladores de CMS y complementos pueden agregar estadísticas a nivel de la página o de la plantilla y verificaciones continuas para las páginas existentes. Por ejemplo, supervisan los cambios en el tiempo para páginas clave a fin de diagnosticar problemas y ayudar a priorizar las correcciones.

Límites de uso

Puedes encontrar una descripción más detallada de los límites de uso de las API de Search Console en la documentación para desarrolladores. En particular, en lo que respecta a la API de inspección de URL, la cuota se aplica por propiedad de sitio web de Search Console (llamadas que buscan el mismo sitio):

  • 2,000 búsquedas por día
  • 600 búsquedas por minuto

Comentarios

Creemos que la nueva API brindará nuevas oportunidades al ecosistema para innovar con datos de la Búsqueda de Google; siempre nos entusiasma ver las soluciones que los desarrolladores y los especialistas en SEO crean en torno a las API de Search Console.

Si tienes preguntas o comentarios, comunícate con nosotros en Twitter o publica una pregunta en la comunidad de la Central de la Búsqueda.