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ámetros | Obligatorio | Descripción |
|---|---|---|
target | Obligatorio | Dominio o subdominio que se analiza, como notion.so; https:// y www. se eliminan, y una URL con ruta se rechaza. |
location_code | Opcional | Có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_name | Opcional | Nombre del país, como United States, en lugar de location_code; si se envían ambos, deben indicar el mismo país. |
language_code | Opcional | Código de idioma, como en, el predeterminado; debe ser uno de los idiomas disponibles en el país elegido. |
language | Opcional | Nombre 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.
- Envíe {"target": "notion.so", "location_code": 2840, "language_code": "en"} por POST a /v1/seo/domain-overview.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- 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.
APIs relacionadas
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.
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API