Search Console

Datos de rendimiento de Google Search Console (impresiones, clics, CTR y posición media) para proyectos con una propiedad de GSC conectada. Se requiere el plan Growth o uno superior. ctr es una fracción entre 0 y 1, y position es la media ponderada por impresiones. La cabecera de respuesta X-Search-Console-Backend indica si la lectura es stored (de datos sincronizados) o live (en directo). Las lecturas de datos sincronizados utilizan esos datos sin contactar con Google. Las lecturas en directo devuelven ERR_SEARCH_CONSOLE_ACCESS_REVOKED (403) si se ha revocado el acceso a Google; vuelve a conectar la propiedad en Preferencias > Configuración del proyecto > Conexiones de datos. Devuelven ERR_SEARCH_CONSOLE_UPSTREAM (503) si Google no está disponible o se ha superado la cuota; espera los segundos indicados en Retry-After antes de volver a intentarlo. Las lecturas de datos sincronizados rechazan con ERR_INVALID_PARAM las solicitudes de consultas, las de páginas y las acotadas. Para consultas y páginas, total cuenta las filas de una única solicitud a Google, hasta 25.000 (truncated: true al alcanzar ese límite). La suma de las filas de una lista no coincide con los totales: para obtener el total de un conjunto de páginas o consultas, llama a /search_console/summary con filters y sin dimension.

GET`/search_console/summary`

Totales principales del período, de toda la propiedad salvo que filters los acote, con un desglose opcional agregado en el mismo período. breakdown_truncated: true indica que el desglose ha dejado filas fuera. Las filas de la dimensión query excluyen las consultas anonimizadas, y las de las dimensiones page y searchAppearance se cuentan por página y no por propiedad, así que las filas del desglose pueden no coincidir con los totales.

Parámetros:

project_idobligatorio
range
from
to
dimensioncountry|device|page|query|searchAppearance
limitpor defecto y máximo 1000
search_typeweb|image|video|news|discover|googleNews
filters
data_statefinal|all
aggregation_typeauto|byPage|byProperty

GET`/search_console/timeseries`

Series agrupadas por día, semana o mes, de toda la propiedad salvo que filters las acote.

Parámetros:

project_idobligatorio
range
from
to
granularityday|week|month
search_typeweb|image|video|news|discover|googleNews
filters
data_statefinal|all
aggregation_typeauto|byPage|byProperty
outputflat|csv

GET`/search_console/queries`

Las principales consultas de búsqueda del período, ordenadas y paginadas. Cuenta deliberadamente de menos las consultas anonimizadas, por lo que no suman exactamente los totales del resumen (igual que en la interfaz de GSC).

Parámetros:

project_idobligatorio
range
from
to
sortimpressions|clicks|ctr|position
page
per_page
start_row
search_typeweb|image|video|news|discover|googleNews
filters
data_statefinal|all
aggregation_typeauto|byPage|byProperty
outputflat|csv

GET`/search_console/pages`

Las principales páginas de destino del período, ordenadas y paginadas. Misma estructura que el endpoint de consultas, donde la clave de cada fila es la URL de una página.

Parámetros:

project_idobligatorio
range
from
to
sortimpressions|clicks|ctr|position
page
per_page
start_row
search_typeweb|image|video|news|discover|googleNews
filters
data_statefinal|all
aggregation_typeauto|byPage|byProperty
outputflat|csv

GET`/search_console/rows`

Filas agrupadas por entre una y tres dimensiones, por ejemplo página y consulta, o fecha y página, ordenadas y paginadas. Cada dimensión va en su propio campo. Google devuelve como máximo 25.000 filas por solicitud: truncated: true indica que ese bloque está completo y start_row lee el siguiente.

Parámetros:

project_idobligatorio
dimensionsobligatorio, de 1 a 3 valores separados por comas de entre date|country|device|page|query|searchAppearance
range
from
to
sortimpressions|clicks|ctr|position
page
per_page
start_row
search_type
filters
data_statefinal|all
aggregation_typeauto|byPage|byProperty
outputflat|csv

Ejemplos de código

Download: OpenAPI Swagger Postman

Preguntar a la IA: Abrir en ChatGPT Abrir en Claude Ver como Markdown

Idioma

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/search_console/summary?project_id=PROJECT_ID&range=30&dimension=page&limit=50"

const response = await fetch("https://api.llmpulse.ai/api/v1/search_console/summary?project_id=PROJECT_ID&range=30&dimension=page&limit=50", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/search_console/summary?project_id=PROJECT_ID&range=30&dimension=page&limit=50",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/search_console/summary?project_id=PROJECT_ID&range=30&dimension=page&limit=50",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/search_console/summary?project_id=PROJECT_ID&range=30&dimension=page&limit=50", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/search_console/summary?project_id=PROJECT_ID&range=30&dimension=page&limit=50', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/search_console/summary?project_id=PROJECT_ID&range=30&dimension=page&limit=50"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/search_console/timeseries?project_id=PROJECT_ID&range=30&granularity=day&data_state=all"

const response = await fetch("https://api.llmpulse.ai/api/v1/search_console/timeseries?project_id=PROJECT_ID&range=30&granularity=day&data_state=all", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/search_console/timeseries?project_id=PROJECT_ID&range=30&granularity=day&data_state=all",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/search_console/timeseries?project_id=PROJECT_ID&range=30&granularity=day&data_state=all",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/search_console/timeseries?project_id=PROJECT_ID&range=30&granularity=day&data_state=all", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/search_console/timeseries?project_id=PROJECT_ID&range=30&granularity=day&data_state=all', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/search_console/timeseries?project_id=PROJECT_ID&range=30&granularity=day&data_state=all"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/search_console/queries?project_id=PROJECT_ID&range=30&per_page=50&filters=[{"dimension":"page","operator":"contains","expression":"/guides/"}]"

const response = await fetch("https://api.llmpulse.ai/api/v1/search_console/queries?project_id=PROJECT_ID&range=30&per_page=50&filters=[{"dimension":"page","operator":"contains","expression":"/guides/"}]", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/search_console/queries?project_id=PROJECT_ID&range=30&per_page=50&filters=[{"dimension":"page","operator":"contains","expression":"/guides/"}]",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/search_console/queries?project_id=PROJECT_ID&range=30&per_page=50&filters=[{"dimension":"page","operator":"contains","expression":"/guides/"}]",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/search_console/queries?project_id=PROJECT_ID&range=30&per_page=50&filters=[{"dimension":"page","operator":"contains","expression":"/guides/"}]", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/search_console/queries?project_id=PROJECT_ID&range=30&per_page=50&filters=[{"dimension":"page","operator":"contains","expression":"/guides/"}]', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/search_console/queries?project_id=PROJECT_ID&range=30&per_page=50&filters=[{"dimension":"page","operator":"contains","expression":"/guides/"}]"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/search_console/pages?project_id=PROJECT_ID&range=30&per_page=50&search_type=news"

const response = await fetch("https://api.llmpulse.ai/api/v1/search_console/pages?project_id=PROJECT_ID&range=30&per_page=50&search_type=news", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/search_console/pages?project_id=PROJECT_ID&range=30&per_page=50&search_type=news",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/search_console/pages?project_id=PROJECT_ID&range=30&per_page=50&search_type=news",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/search_console/pages?project_id=PROJECT_ID&range=30&per_page=50&search_type=news", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/search_console/pages?project_id=PROJECT_ID&range=30&per_page=50&search_type=news', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/search_console/pages?project_id=PROJECT_ID&range=30&per_page=50&search_type=news"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Search Console

GET/search_console/summary

GET/search_console/timeseries

GET/search_console/queries

GET/search_console/pages

GET/search_console/rows

GET`/search_console/summary`

GET`/search_console/timeseries`

GET`/search_console/queries`

GET`/search_console/pages`

GET`/search_console/rows`