Documentacion API de TrueRanker
Accede a la documentación oficial de la API de TrueRanker. Aprende a integrar datos de keywords y rankings en tiempo real en tus propias herramientas.
Actualizado el
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/list?key=YOUR_API_KEY
Parámetros:
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| key | String | Sí | Tu API Key. |
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ámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| key | String | Sí | Tu API Key. |
| project | Integer | Sí | El ID del Proyecto. |
| start | Date | Sí | Fecha de inicio en formato YYYYMMDD. |
| end | Date | Sí | Fecha de fin en formato YYYYMMDD. |
Estructura de la respuesta:
Array
(
[ok] => true
[data] => Array
(
[keywords] => Array
(
[0] => Array
(
[id] => 7207640
[keyword] => "rank tracking"
[tags] => Array ( [0] => "tag1", [1] => "tag2" )
[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"
[tags] => Array ( [0] => "tag1", [1] => "tag2" )
[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ámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| key | String | Sí | Tu API Key. |
| project | Integer | Sí | El ID del Proyecto. |
| start | Date | Sí | Fecha de inicio en formato YYYYMMDD. |
| end | Date | Sí | 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 campoerrorpara ver una descripción del problema (ej: «Invalid API Key», «Project not found»).