Dostęp do API — plan, zakup, aktywacja
Zanim wyślesz pierwsze żądanie, konto musi mieć dostęp do API. Ta strona odpowiada na cztery pytania, które najczęściej trafiają do supportu.
Kto ma dostęp
| Plan | Dostęp do API |
|---|---|
| Advanced, Prime | wliczony w cenę planu |
| Basic | dodatek — 99 zł/mies. |
| Lite | dodatek — 199 zł/mies. |
Ceny wyżej to stawka miesięczna, ale dodatek kupujesz na tyle, ile zostało Twojego planu, i płacisz proporcjonalnie za te dni. Przy pakiecie rocznym ze 100 dniami do końca zapłacisz za 100 dni dodatku, a nie za jeden miesiąc; przy pakiecie rozliczanym miesięcznie wychodzi dokładnie miesiąc. Porównanie pakietów: cennik Senuto (ceny dodatku: stan na 2026-08-12).
Dodatek API obejmuje też serwer MCP. Sam MCP, bez bezpośredniego dostępu do REST API, jest tańszym, osobnym dodatkiem — czego potrzebujesz do MCP.
Jak dokupić
Dodatek włączasz samodzielnie w aplikacji, bez kontaktu z handlowcem: app.senuto.com/user/user-package — tam też zarządzasz nim później. Potrzebujesz faktury proforma? Napisz na czacie w aplikacji.
Nie wiąże Cię żadna dłuższa umowa. Dodatek kończy się razem z bieżącym okresem planu i odnawia razem z nim, a rezygnacja polega na nieprzedłużeniu go w panelu — po zakończeniu opłaconego okresu dostęp do API wygasa sam. Nie musisz nikomu tego zgłaszać ani wysyłać wypowiedzenia.
Nie ma darmowego trialu API. Nie da się przetestować endpointów bez wykupionego dostępu (albo pakietu Advanced/Prime, gdzie API jest w cenie). Jeśli potrzebujesz sprawdzić API przed decyzją, napisz na czacie w aplikacji do supportu — takie przypadki rozpatrywane są indywidualnie. Sama dokumentacja jest w całości publiczna: przykłady żądań i odpowiedzi zobaczysz na stronach endpointów bez logowania.
Dodatek API daje dostęp do tego, co masz w planie — nie dokłada modułów. Konto bez dodatku Analiza SERP nie wywoła endpointów SERP także przez API. W obrębie wykupionych modułów zakres jest identyczny w każdym pakiecie (te same endpointy, ta sama dokumentacja), różnią się limity: każde konto konsumuje własne pule, a ich wysokość zależy od pakietu (patrz Limity zapytań).
Kiedy zacznie działać
Od razu po zakupie. Nie ma okresu oczekiwania ani ręcznej aktywacji po stronie Senuto — zaraz po opłaceniu dodatku możesz pobrać token i wysłać pierwsze żądanie.
Token wygenerujesz w panelu — Ustawienia konta → Integracje ,
kafelek API — albo wywołując POST /api/users/token z e-mailem i hasłem swojego konta.
Jak sprawdzić, czy dostęp działa
Najprostszy test — pobierz token, a potem zapytaj o dane zalogowanego konta:
# 1. token (ważny 31 dni)
curl --location --request POST 'https://api.senuto.com/api/users/token' \
--header 'Content-Type: application/json' \
--data-raw '{ "email": "twoj@email.com", "password": "TWOJE_HASŁO" }'
# 2. test tokenu
curl --location 'https://api.senuto.com/api/users/whoami' \
--header 'Authorization: Bearer TWOJ_TOKEN'Odpowiedź {"success": true, "data": {"email": "..."}} oznacza, że wszystko gra.
Co może pójść nie tak:
| Objaw | Znaczenie |
|---|---|
418 + Invalid username or password | złe dane logowania (to hasło do aplikacji Senuto, nie osobne API) |
418 + Email isnt confrimed | konto z niepotwierdzonym adresem — kliknij link z maila rejestracyjnego, a gdy go nie masz, poproś support o ponowne wysłanie |
403 z pustym message | konto nie ma aktywnego planu albo dodatku Dostęp do API |
302 na …/users/login, a po przekierowaniu 404 z pustym message | token wygasł, jest błędny albo nie wysłałeś nagłówka Authorization |
Limity, które przysługują Twojemu kontu, odczytasz jednym wywołaniem —
GET /api/users/getLimits (nie zużywa żadnej jednostki).