The alternative SEO rank tracker

¿Cómo funciona TrueRanker?

Documentacion API de TrueRanker

La API de TrueRanker te permite recuperar de forma programática tus proyectos, palabras clave y datos de posicionamiento. Esta funcionalidad está disponible para usuarios a partir del Plan Agency.

Autenticación #

Para utilizar la API, necesitas tu API Key (Clave API).

  • Puedes encontrar tu API Key en tu cuenta de TrueRanker, en Configuración de la cuenta > API.
  • Alternativamente, si utilizas el plugin de WordPress, se encuentra en la sección del menú del plugin.

Todas las peticiones deben incluir el parámetro key en la URL.

Endpoints de la API #

URL Base: https://app.trueranker.com/data

1. Obtener lista de proyectos #

Recupera todos los proyectos asociados a tu cuenta.

Petición (Request):

https://app.trueranker.com/data/project/keyword/list?key=YOUR_API_KEY&project=12345&start=20230101&end=20230131

Parámetros:

ParámetroTipoObligatorioDescripción
keyStringSíTu API Key.

Ejemplo:

Estructura de la Respuesta:

Array
(
[ok] => true
[data] => Array
(
[projects] => Array
(
[0] => Array
(
[id] => 94698
[created_at] => «2025-07-25 09:23:50»
[domain] => «ahrefs.com»
[num_keywords] => 23
[project_name] => «Ahrefs»
)
[1] => Array
(
[id] => 12350
[created_at] => «2020-04-23 08:27:52»
[domain] => «alaves.net»
[num_keywords] => 284
[project_name] => «Alaves Innovation 🏕️»
)
[2] => Array
(
[id] => 98648
[created_at] => «2025-12-03 11:57:18»
[domain] => «artdecoracionenvidrio.com»
[num_keywords] => 10
[project_name] => «Art decoración en Vidrio»
)
// … más proyectos en la lista
)
)
)

2. Obtener palabras clave y rankings por rango de fechas #

Recupera datos de palabras clave y su historial de posicionamiento entre dos fechas específicas.

Petición (Request):

https://app.trueranker.com/data/project/keyword/list?key=YOUR_API_KEY&project=12345&start=20230101&end=20230131

Parámetros:

ParámetroTipoObligatorioDescripción
keyStringSíTu API Key.
projectIntegerSíEl ID del Proyecto.
startDateSíFecha de inicio en formato YYYYMMDD.
endDateSíFecha de fin en formato YYYYMMDD.

Estructura de la respuesta:

Array
(
[ok] => true
[data] => Array
(
[keywords] => Array
(
[0] => Array
(
[id] => 7207640
[keyword] => «rank tracking»
[location] => «España»
[country] => «ES»
[device] => «desktop»
[volume] => 390
[best_rank_ever] => 3
[cpc] => «2.3150»
[rank] => Array
(
[«2026-02-01»] => Array ( [rank] => 3, [url] => «https://trueranker.com/», [few] => true )
[«2026-02-02»] => Array
(
[rank] => 7
[ov] => 11.988
[ai] => Array ( [snp] => true )
)
)
)
[1] => Array
(
[id] => 7207650
[keyword] => «seo competition tracker»
[location] => «España»
[country] => «ES»
[device] => «desktop»
[volume] => 50
[best_rank_ever] => 6
[cpc] => «0.0000»
[rank] => Array
(
[«2026-02-01»] => Array ( [rank] => 6, [url] => «https://trueranker.com/…», [ai] => Array ( [snp] => true ) )
[«2026-02-02»] => Array ( [rank] => 7, [few] => true )
)
)
)
)
)

Devuelve los datos de la palabra clave (igual que en el punto anterior) más un array/objeto que contiene las posiciones diarias y las URLs para el rango de fechas especificado.

3. Obtener competidores y rankings de sus posiciones #

Recupera los datos de tus competidores y sus posiciones para tus palabras clave

Petición (Request):

https://app.trueranker.com/data/project/competitor/keyword/list?key=YOUR_API_KEY&project=12345&start=20230101&end=20230131

Parámetros:

ParámetroTipoObligatorioDescripción
keyStringSíTu API Key.
projectIntegerSíEl ID del Proyecto.
startDateSíFecha de inicio en formato YYYYMMDD.
endDateSíFecha de fin en formato YYYYMMDD.

Estructura de la Respuesta:

Array
(
[ok] => 1
[data] => Array
(
[num_keywords] => 2
[competitors] => Array
(
[0] => Array
(
[id] => 104686
[name] => «nightwatch.io»
[competitor_domain] => 27115
[active_at] => «2025-10-17 12:30:16»
[icon] => «\img\domains\favicon\n\27115.png»
[row_id] => «nightwatch_io»
)
[1] => Array
(
[id] => 104685
[name] => «wincher.com»
[competitor_domain] => 27122
[active_at] => «2025-10-17 12:30:04»
[icon] => «\img\domains\favicon\w\27122.png»
[row_id] => «wincher_com»
)
)
[keywords] => Array
(
[0] => Array
(
[id] => 7207640
[keyword] => «rank tracking»
[location] => «España»
[country] => «ES»
[device] => «desktop»
[volume] => 390
[best_rank_ever] => 3
[cpc] => «2.3150»
[rank] => Array
(
[«2026-02-01»] => Array ( [rank] => 3, [url] => «https://trueranker.com/», [cr] => Array ( [«nightwatch.io»] => 8, [«wincher.com»] => 15 ) )
[«2026-02-02»] => Array ( [rank] => 7, [ov] => 11.988, [cr] => Array ( [«nightwatch.io»] => 0, [«wincher.com»] => 4 ) )
)
)
[1] => Array
(
[id] => 7207650
[keyword] => «seo competition tracker»
[location] => «España»
[country] => «ES»
[device] => «desktop»
[volume] => 50
[best_rank_ever] => 6
[cpc] => «0.0000»
[rank] => Array
(
[«2026-02-01»] => Array
(
[rank] => 6
[url] => «https://trueranker.com/seo-competitors-tool/»
[ai] => Array ( [snp] => 1 )
[cr] => Array
(
[«nightwatch.io»] => Array ( [rank] => 0, [ov] => 0 )
[«wincher.com»] => Array ( [rank] => 10, [ov] => 7.602 )
)
)
[«2026-02-02»] => Array
(
[rank] => 7
[cr] => Array ( [«nightwatch.io»] => 0, [«wincher.com»] => 4 )
)
)
)
)
)
)

Gestión de Errores #

Todas las peticiones devuelven un objeto JSON. Comprueba el campo booleano ok.

  • Si ok: true, la petición fue exitosa.
  • Si ok: false, revisa el campo error para ver una descripción del problema (ej: «Invalid API Key», «Project not found»).
Imagen de Javier Quevedo
Javier Quevedo
Actualizado el 26 marzo 2026