Projekty z rozszerzonymi danymi (getListWithExtendedData)
/api/rank_tracker/management/projects/getListWithExtendedDataZwraca listę Twoich projektów Rank Trackera razem ze statystykami — liczbą monitorowanych fraz, rozkładem pozycji (TOP3 / TOP10 / TOP50), średnią pozycją, widocznością organiczną oraz liczbą wzrostów i spadków. Jedno żądanie zastępuje pobranie listy projektów i osobnego raportu pozycji dla każdego z nich. Zakres obejmuje projekty własne oraz udostępnione Twojemu kontu.
Żądanie
GET /api/rank_tracker/management/projects/getListWithExtendedData
Nagłówki: Authorization: Bearer <token>.
Parametry przekazuje się w query stringu.
Żądanie
{
"limit": 2,
"page": 1
}Parametry
| Name | Type | Default |
|---|---|---|
limit | numberLiczba projektów na stronę. | |
page | numberNumer strony. | |
order | { prop: string; dir: "ASC" | "DESC"; }Sortowanie listy projektów. | |
filtering | Record<string, unknown>[]Filtry listy projektów. | |
tags | number[]Zawężenie do projektów oznaczonych wskazanymi tagami. Wartość inna niż tablica jest ignorowana. |
W odpowiedzi są dwa klucze wykresu: poprawny visibility_chart i literówka visiblity_chart (brak drugiego i). Oba istnieją i zawierają to samo. Czytaj visibility_chart, ale nie zdziw się drugim polem.
To metoda GET — order, filtering, tags, limit i page przekazuje się w query stringu. tags przekazane jako wartość inna niż tablica jest po cichu ignorowane.
Lista zawiera także projekty udostępnione Twojemu kontu, nie tylko własne — rozróżnisz je polem project.is_owner.
Odpowiedź
Przykład to rzeczywista odpowiedź produkcyjna, skrócona.
{
"success": true,
"data": [
{
"project": {
"id": 1234,
"domain": "example.com",
"name": "medonet",
"country_id": "1",
"region_id": "22440",
"project_fit_id": "1",
"status": "1",
"is_crawled": "1",
"is_owner": false,
"last_update": "2026-08-24",
"tags": []
},
"dates": {
"last_date": {
"timestamp": 1787529600,
"formatted": "2026-08-24"
},
"previous_data": {
"timestamp": 1787443200,
"formatted": "2026-08-23"
}
},
"statistics": {
"keywords_count": {
"older_value": "100",
"recent_value": "100",
"diff": 0,
"percent": 0
},
"top3": {
"older_value": 0,
"recent_value": 0,
"diff": 0,
"percent": 0
},
"top10": {
"older_value": 9,
"recent_value": 8,
"diff": -1,
"percent": -0.1111
},
"top50": {
"older_value": 64,
"recent_value": 67,
"diff": 3,
"percent": 0.0469
},
"avg_pos": {
"older_value": 34.89,
"recent_value": 34.61,
"diff": -0.28,
"percent": -0.008
},
"organic_visibility": {
"older_value": 12219,
"recent_value": 13514,
"diff": 1295,
"percent": 0.106
},
"wins": {
"older_value": 19,
"recent_value": 28,
"diff": 9,
"percent": 0.4737
},
"lost": {
"older_value": 31,
"recent_value": 27,
"diff": -4,
"percent": -0.129
}
},
"visibility_chart": [],
"visiblity_chart": []
}
],
"pagination": {
"page_count": 2,
"current_page": 1,
"has_next_page": true,
"has_prev_page": false,
"count": "4",
"limit": 2
}
}Struktura odpowiedzi
| Name | Type | Default |
|---|---|---|
success | boolean | |
data | { project: Record<string, unknown>; dates: { last_date: { timestamp: number; formatted: string; }; previous_data: { timestamp: number; formatted: string; }; }; statistics: { keywords_count: number; ... 16 more ...; no_change: number; }; visibility_chart: unknown[]; visiblity_chart: unknown[]; }[] | |
pagination | { page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: number; limit: number; } |
Błędy
Błędy tego endpointu przychodzą we wspólnej kopercie ze statusem 418.
Powiązane akcje
getMyActiveProjects— lekka lista projektów (id,domain,name).getMyGroupsInProject— grupy fraz w projekcie.positions/getData— pełny raport pozycji projektu.