Frazy: słowa kluczowe projektu (getProjectKeywords)
/api/rank_tracker/reports/keywords/getProjectKeywordsZwraca listę słów kluczowych przypisanych do projektu Rank Tracker (Monitoring) — wyłącznie pary id + keyword, wraz z metadanymi paginacji. Endpoint nie zwraca danych pozycyjnych ani czasowych; służy do pobrania pełnego zbioru fraz monitorowanych w projekcie.
| Fraza | ID |
|---|---|
| jak wychowac szczeniaka | 690709 |
| karma dla szczeniaka maltanczyka | 704922 |
projekt Rank Trackera, limit: 2, strona 2. Endpoint zwraca wyłącznie pary id + keyword. Wszystkie adresowalne pola wiersza.
Żądanie
POST /api/rank_tracker/reports/keywords/getProjectKeywords
Nagłówki: Authorization: Bearer <token>, Content-Type: application/json. Parametry przekazuje się w ciele żądania (JSON).
Struktura żądania
Podstawowy
{
"project_id": null
}Parametry
| Name | Type | Default |
|---|---|---|
project_id | numberWymagane. ID projektu Rank Tracker (Monitoring). Pobierz przez
| |
limit | numberLiczba słów kluczowych na stronę (paginacja). Nieujemna liczba całkowita. Maksymalny limit po stronie kontrolera = 100. | 10 |
page | numberNumer strony (paginacja). Nieujemna liczba całkowita. | 1 |
Jeśli pominiesz limit, paginacja używa wartości domyślnej 10 (od niej liczone jest page_count), ale pole pagination.limit w odpowiedzi zwraca wtedy null zamiast 10 — paginator zwraca surową wartość z żądania, a nie efektywny limit. Przy jawnie podanym limit (np. limit: 2) pole pagination.limit jest poprawne.
Metoda to POST — kontroler oraz walidator czytają dane z ciała żądania (getData), nie z query stringu. Jedynym wymaganym parametrem jest project_id; jego pominięcie zwraca 418 z invalid_data. Brak dostępu do projektu (nie jesteś właścicielem, nie masz roli admina ani współdzielenia ACL) również zwraca 418 z komunikatem Unauthorized access. Wbrew starszej dokumentacji ta akcja nie obsługuje parametrów date_min / date_max — są one ignorowane i nie mają wpływu na wynik.
Odpowiedź
Po pomyślnym żądaniu otrzymujesz data (tablicę słów kluczowych) oraz pagination. Pole count w pagination to całkowita liczba słów kluczowych w projekcie.
Skrócona
{
"success": true,
"data": [
{ "id": 690709, "keyword": "jak wychowac szczeniaka" }
],
"pagination": { "page_count": 47, "current_page": 2, "count": 94, "limit": 2 }
}Struktura odpowiedzi
| Name | Type | Default |
|---|---|---|
success | boolean
| |
data | ProjectKeyword[]Zwrócone słowa kluczowe projektu | |
pagination | { page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: number; limit: number | null; }Metadane paginacji |
Błędy
| Name | Type | Default |
|---|---|---|
success | false | |
data | { error: { type: string; message?: string; params?: Record<string, Record<string, string>>; }; } |
418 jest zwracane również w przypadku błędów walidacji oraz braku uprawnień — nie tylko przy ograniczaniu liczby żądań. Brak project_id →
{"success":false,"data":{"error":{"type":"invalid_data","params":{"project_id":{"_required":"This field is required"}}}}}.
Brak dostępu do projektu →
{"success":false,"data":{"error":{"type":"unauthorized","message":"Unauthorized access"}}}.
Powiązane akcje
getProjectKeywords— lista słów kluczowych projektu (ta strona)getGroupKeywords— lista słów kluczowych grupy (wymagagroup_id)getData— raport słów kluczowych z filtrowaniem i sortowaniem (group_id+project_id)getSerpHtml— zapisany HTML SERP dla frazy (keyword_id+date)getBestKeywords— najlepsze frazy projektugetProjectsStatus— status projektów