Docs
Buscar documentación...⌘K

Historial de palabras clave

API + MCP
GET/v3/gsc/keyword-history

Las solicitudes a este endpoint son gratuitas y no consumen ninguna unidad de API.

Parámetros de consulta

wherestring

Campos compatibles:

  • url

El filtro es una cadena JSON que representa una expresión booleana; debe seguir la siguiente estructura:

<bool_filter> ::= { "and" : <bool_filter>+ }
              |   { "or" : <bool_filter>+ }
              |   { "not" : <bool_filter> }
              |   <expr>

<expr> ::= {
             "field" : <dimension|metric>,
             ? "is": <condition>,
           }

<condition> ::= [ "eq", <value> ]
            |   [ "neq", <value> ]
            |   [ "gt", <value> ]
            |   [ "gte", <value> ]
            |   [ "lt", <value> ]
            |   [ "lte", <value> ]
            |   [ "substring", <value> ]
            |   [ "isubstring", <value> ]
            |   [ "phrase_match", <value> ]
            |   [ "iphrase_match", <value> ]
            |   [ "prefix", <value> ]
            |   [ "suffix", <value> ]
keywordsstring

Una lista de palabras clave separadas por comas para obtener datos históricos.

devicestring

Filtrar por tipo de dispositivo (DESKTOP, MOBILE, TABLET). Si no se especifica, se incluyen todos los dispositivos.

Valores permitidos:desktopmobiletablet
countrystring

Un código de país de dos letras (ISO 3166-1 alpha-2).

Valores permitidos:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
history_groupingstring

El intervalo de tiempo utilizado para agrupar los datos históricos.

Valores permitidos:dailyweeklymonthly
Opción predeterminada:monthly
date_tostring

La fecha de finalización del periodo histórico en formato AAAA-MM-DD.

date_fromstringObligatorio

La fecha de inicio del periodo histórico en formato AAAA-MM-DD.

portfolio_idinteger

ID del portfolio. Cuando se proporciona, agrega los datos de todos los proyectos conectados a GSC del portfolio.

project_idinteger

ID del proyecto. Obligatorio cuando no se proporciona portfolio_id.

outputstring

El formato de salida.

Valores permitidos:jsoncsvxmlphp

Respuestas

metricsarray<object>
keywordstring
datestring
clicksinteger
impressionsinteger
ctrnumber
positionnumber

Posición media (decimal, p. ej., 4.7)