seo/
domain-overview

Obtenga los totales de búsqueda orgánica y de pago en Google de un dominio para un país y un idioma: palabras clave posicionadas, tráfico mensual y su costo en anuncios, rangos de posición y cambios de posicionamiento.

Domain Overview API

Totales orgánicos y de pago
Rangos de posición 1–100
Mercado por país e idioma
5 créditos por solicitud
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Domain Overview

La huella de búsqueda de un dominio es su presencia en los resultados de Google para un país y un idioma, resumida en la cantidad de palabras clave por las que se posiciona, las visitas mensuales que se estima que le traen esas posiciones y lo que costaría ese tráfico en anuncios, separada en orgánica y de pago y repartida en rangos de posición del 1 al 100 con conteos de posiciones nuevas, en alza, en baja y perdidas. Una fila con estos totales dimensiona a un competidor, califica a un prospecto por su presencia en búsqueda y, guardada mes a mes, sigue cómo evoluciona la visibilidad del propio sitio.

Funcionalidades de la Domain Overview API

  • Un dominio en un mercado de Googletarget recibe un dominio, y los parámetros de ubicación e idioma eligen el país y el idioma de los resultados, con Estados Unidos e inglés como valores predeterminados; la fila repite location_code y language_code para que las capturas guardadas queden etiquetadas.
  • Orgánico y de pago con la misma estructuraorganic y paid llevan el mismo conjunto de totales, así que las posiciones sin pago y los anuncios de búsqueda se comparan campo por campo.
  • El tráfico con su valor publicitariokeywords_count cuenta las palabras clave posicionadas, estimated_traffic da las visitas mensuales que generan y estimated_traffic_cost pone precio a ese tráfico en dólares estadounidenses según las tarifas de Google Ads.
  • Doce rangos de posiciónpositions divide las palabras clave posicionadas en pos_1, pos_2_3, pos_4_10 y otros rangos hasta pos_91_100, y muestra si un dominio gana la primera página o se ubica más abajo en los resultados.
  • Movimientos de posición desde la última actualizaciónnew_count, up_count, down_count y lost_count indican cuántas palabras clave entraron, subieron, bajaron o salieron de las posiciones desde la actualización de datos anterior.

Parámetros de la Domain Overview API

ParámetrosObligatorioDescripción
targetObligatorioDominio o subdominio que se analiza, como notion.so; https:// y www. se eliminan, y una URL con ruta se rechaza.
location_codeOpcionalCódigo numérico del país de búsqueda, como 2840 para Estados Unidos, que es el predeterminado. Use este parámetro o location_name.
location_nameOpcionalNombre del país, como United States, en lugar de location_code; si se envían ambos, deben indicar el mismo país.
language_codeOpcionalCódigo de idioma, como en, el predeterminado; debe ser uno de los idiomas disponibles en el país elegido.
languageOpcionalNombre del idioma, como English, en lugar de language_code; si se envían ambos, deben coincidir.

Cómo usar la Domain Overview API

Envíe un dominio con su mercado y lea la fila de resumen cuando la tarea termine.

  1. Envíe {"target": "notion.so", "location_code": 2840, "language_code": "en"} por POST a /v1/seo/domain-overview.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. Lea la única fila de resumen en results.items; results.next_cursor solo importa cuando has_more es true.
curl -X POST "https://api.socq.ai/v1/seo/domain-overview" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"notion.so","location_code":2840,"language_code":"en"}'

# One market per request, 5 credits.

Casos de uso de la Domain Overview API

  • Dimensionar la presencia en búsqueda de un competidor: Lea organic.keywords_count y organic.estimated_traffic para ver qué parte de un mercado ya alcanza un rival a través de Google.
  • Seguir su propia visibilidad mes a mes: Guarde cada mes los rangos de positions y los conteos de nuevas, en alza, en baja y perdidas para graficar si las posiciones avanzan hacia la primera página.
  • Calificar prospectos de una agencia: Use organic.estimated_traffic_cost como cifra en dólares de lo que vale el tráfico de búsqueda de un prospecto al decidir qué cuentas buscar.
  • Comprobar si un sitio compra anuncios de búsqueda: paid.keywords_count y paid.estimated_traffic muestran si un dominio tiene anuncios de búsqueda de Google en el mercado y cuánto tráfico le aportan.
  • Comparar un sitio entre países: Envíe el mismo dominio con distintas configuraciones de ubicación e idioma para ver en qué mercados es más fuerte.

Consejos de expertos para la Domain Overview API

  • Para un país donde no se ofrece inglés, defina usted mismo language_code o language, porque el predeterminado en solo se acepta donde ese país incluye el inglés.
  • Sume pos_1, pos_2_3 y pos_4_10 para obtener la cantidad de palabras clave en la primera página, ya que los rangos son intervalos separados que no se superponen.
  • Interprete los conteos de nuevas, en alza, en baja y perdidas como cambios desde la actualización de datos anterior, no desde su última solicitud, y guarde cada fila con collected_at para armar su propio historial.
  • Envíe el dominio simple; para cifras de páginas individuales del sitio, use Relevant Pages API, que reporta la distribución de posiciones página por página.

Además de la Domain Overview API, use estas APIs cuando necesite otro tipo de datos públicos de SEO.

  • Google Organic SERP API — Obtiene una página de resultados de Google en vivo por consulta y mercado, con destinos normalizados, posiciones, tipos de elemento y detalles completos de los resultados.
  • Keyword Difficulty API — Compara la dificultad de posicionamiento orgánico de un lote de palabras clave enviado, y devuelve cada palabra clave disponible con su puntuación normalizada.
  • Keyword Overview API — Enriquece un lote de palabras clave enviado con el contexto disponible de demanda, competencia de pago, dificultad, búsquedas mensuales e intención.
  • Ranked Keywords API — Encuentra las palabras clave para las que se posiciona un dominio, subdominio o página, con las URLs correspondientes, posiciones, mediciones de búsqueda, intención y elementos de origen completos.
  • Competitor Domains API — Encuentra los dominios que se posicionan con las mismas palabras clave de Google que un sitio en un mercado, con palabras clave compartidas, posición media, tráfico de la coincidencia y totales de búsqueda completos.
  • Traffic Estimate API — Estima las visitas mensuales de búsqueda orgánica y de pago en Google y la cantidad de palabras clave de hasta 1,000 dominios en un mercado.

Explorar otras plataformas

Combine los datos de SEO con datos públicos de otras plataformas sociales compatibles.

Domain Overview API — FAQ

Domain Overview API es una interfaz programática para leer los totales de búsqueda en Google de un dominio en un país y un idioma elegidos. Devuelve los conteos de palabras clave orgánicas y de pago, el tráfico mensual estimado y su costo en anuncios, las posiciones por rango y los conteos de palabras clave nuevas, en alza, en baja y perdidas.

Revisa el tráfico de búsqueda: estimated_traffic es la cantidad mensual de visitas que se estima que un dominio recibe desde los resultados de Google en el mercado elegido, reportada por separado para resultados orgánicos y de pago.

Defina el país con location_code o location_name y el idioma con language_code o language; el idioma debe ser uno de los que se ofrecen en ese país. Sin ellos, la solicitud usa Estados Unidos e inglés.

Es el costo mensual estimado, en dólares estadounidenses, de comprar ese mismo tráfico con Google Ads, lo que convierte la visibilidad orgánica en una cifra monetaria comparable.

Cada solicitud cubre un dominio. Para comparar el tráfico y la cantidad de palabras clave de una lista larga, Traffic Estimate API acepta hasta 1,000 dominios a la vez.

Una tarifa fija de 5 créditos por solicitud, que cubre un dominio en un mercado.