Frazy: statusy projektów (getProjectsStatus)

Zwraca statusy przetwarzania fraz wszystkich projektów zalogowanego użytkownika. Akcja działa na poziomie użytkownika — nie przyjmuje żadnych parametrów, a wynikiem jest tablica z jednym wpisem na projekt: identyfikatorem projektu oraz listą statusów z liczbą fraz w każdym z nich. Typowe zastosowanie: sprawdzenie, czy frazy projektu są już przetworzone (complete), zanim pobierzesz raporty pozycji (np. getData). Wynik nie jest stronicowany.

Żądanie

POST /api/rank_tracker/reports/keywords/getProjectsStatus

Nagłówki: Authorization: Bearer <token>, Content-Type: application/json.

Struktura żądania

{}

curl --location --request POST 'https://api.senuto.com/api/rank_tracker/reports/keywords/getProjectsStatus' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer $YOUR_TOKEN_HERE' \
  --data-raw '{}'

Parametry

Akcja nie przyjmuje żadnych parametrów — wyślij puste ciało {}. Zakres danych wyznacza wyłącznie zalogowany użytkownik (token Authorization): odpowiedź obejmuje wszystkie jego projekty Rank Tracker.

Odpowiedź

Po pomyślnym żądaniu otrzymujesz data — tablicę z jednym elementem na każdy projekt użytkownika, bez paginacji. Każdy element zawiera id projektu (string) oraz tablicę statuses z parami: nazwa statusu (np. complete) i liczba fraz w tym statusie (count, string).

{
  "success": true,
  "data": [
    { "id": "87944", "statuses": [{ "status": "complete", "count": "94" }] }
  ]
}

{
  "success": true,
  "data": [
    {
      "id": "87908",
      "statuses": [
        {
          "status": "complete",
          "count": "58"
        }
      ]
    },
    {
      "id": "87913",
      "statuses": [
        {
          "status": "complete",
          "count": "100"
        }
      ]
    },
    {
      "id": "87944",
      "statuses": [
        {
          "status": "complete",
          "count": "94"
        }
      ]
    }
  ]
}

Struktura odpowiedzi

Błędy

Powiązane akcje

• getProjectKeywords — słowa kluczowe całego projektu (POST, project_id)
• getGroupKeywords — lekka lista (id + keyword) ograniczona do jednej grupy
• getData — pełne statystyki pozycji (POST, project_id + group_id + filtering + order)
• getSerpHtml — zapis HTML wyników SERP (POST, keyword_id + date + project_id)
• getBestKeywords — najlepsze frazy projektu (zawsze 10 wierszy)
• getProjectsStatus — statusy przetwarzania fraz wszystkich projektów użytkownika (ta strona)