The alternative SEO rank tracker

How does TrueRanker works?

TrueRanker API Documentation

The TrueRanker API allows you to programmatically retrieve projects, keywords, and ranking data. This feature is available for users on the Agency Plan and above.

Authentication #

To use the API, you need your API Key.

All requests must include the key parameter in the URL.

API Endpoints #

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

1. Get List of Projects #

Retrieves all projects associated with your account.

Request:

https://app.trueranker.com/data/project/list?key=YOUR_API_KEY

Parameters:

ParameterTypeRequiredDescription
keyStringYesYour API Key.

Response Structure:

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] => “trueranker.com”
[num_keywords] => 284
[project_name] => “TrueRanker”
)
[2] => Array
(
[id] => 98648
[created_at] => “2025-12-03 11:57:18”
[domain] => “semrush.com”
[num_keywords] => 10
[project_name] => “Semrush”
)
// … more projects
)
)
)

2. Get Keywords & Ranks by Date Range #

Retrieves keyword data and their ranking history between two specific dates.

Request:

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

Parameters:

ParameterTypeRequiredDescription
keyStringYesYour API Key.
projectIntegerYesThe Project ID.
startDateYesStart date in YYYYMMDD format.
endDateYesEnd date in YYYYMMDD format.

Response:

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 )
)
)
)
)
)

3. Get Competitors & Ranks by Date Range #

Retrieves competitors keywords data and their ranking history between two specific dates.

Request:

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

Parameters:

ParameterTypeRequiredDescription
keyStringYesYour API Key.
projectIntegerYesThe Project ID.
startDateYesStart date in YYYYMMDD format.
endDateYesEnd date in YYYYMMDD format.

Response:

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 )
)
)
)
)
)
)

Error Handling #

All requests return a JSON object. Check the ok boolean field.

  • If ok: true, the request was successful.
  • If ok: false, check the error field for a description of the problem (e.g., “Invalid API Key”, “Project not found”).
Picture of Javier Quevedo
Javier Quevedo
Updated on 26 March 2026