NETIKER DATA API · V1

Twoje raporty.
W Twoich narzędziach.

Czytaj zapisane dane konta przez HTTPS jako JSON lub CSV. API udostępnia raporty i historię zadań; nie pobiera nowych danych od dostawców i nie wykonuje zmian.

1. Utwórz klucz

W ustawieniach konta wybierz zakres i termin ważności. Zapisz klucz w sekrecie aplikacji lub zmiennej środowiskowej NETIKER_API_KEY. Przesyłaj go w nagłówku Authorization: Bearer …. Klucze nie działają w adresach URL ani jako logowanie do panelu.

reports:read udostępnia zapisane raporty i ich wiersze. runs:read udostępnia historię synchronizacji i eksportów. Dostęp obejmuje dane właściciela klucza. API jest przeznaczone do wywołań serwerowych; nie osadzaj sekretu w publicznym kodzie przeglądarki.

2. Znajdź raport

curl 'https://netiker.com/api/v1/reports?limit=50' \
  -H "Authorization: Bearer $NETIKER_API_KEY"

Odpowiedź zawiera data oraz pagination.nextCursor. Każdy raport ma id i kind: seo dla GSC i importów CSV, table dla raportów tabelarycznych albo ahrefs dla metryk domen. Możesz filtrować listę parametrami kind i provider.

3. Odczytaj wiersze

GET https://netiker.com/api/v1/reports/{kind}/{id}
GET https://netiker.com/api/v1/reports/{kind}/{id}/rows?limit=100
GET https://netiker.com/api/v1/reports/{kind}/{id}/rows?limit=100&format=csv

Metadane opisują kolumny. Wiersze JSON zachowują liczby i wartości puste. Kwoty zachowują jednostki dostawcy — np. Stripe używa najmniejszych jednostek waluty. Szacunki Ahrefs pozostają osobno od pomiarów GSC. truncated: true oznacza, że zapisany raport ma ograniczony zakres wyników dostawcy.

Stronicowanie

Listy zwracają maksymalnie 100 pozycji, a wiersze raportu maksymalnie 500 na żądanie. Odczytuj kolejne strony, dopóki nextCursor nie będzie pusty. Przy dużych wierszach strona może zawierać mniej wyników. Cursor jest ważny 24 godziny i działa dla tego samego konta, zasobu oraz filtrów; nie modyfikuj go.

Dla CSV następny adres znajduje się w nagłówku Link, a cursor także w X-Next-Cursor. Każda strona CSV zawiera nagłówek kolumn. Eksport CSV chroni komórki przed interpretowaniem tekstu jako formuł arkusza.

Historia wykonań

GET https://netiker.com/api/v1/runs?kind=sync&limit=50
GET https://netiker.com/api/v1/runs?kind=sheets&limit=50

Ten zasób wymaga runs:read. Zwraca stan, czas, liczbę prób i wynik zadania. Nie ujawnia danych logowania do źródeł.

Limity i błędy

Wszystkie klucze konta współdzielą limity minutowe i dzienne pokazane w ustawieniach. Zalogowane żądania z błędnymi parametrami lub brakującym zakresem również się wliczają. Dzienny limit resetuje się o północy UTC. Pobrania ze źródeł i wysyłki do Google Sheets mają osobne limity.

Nagłówki X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset i X-RateLimit-Day-Remaining opisują wykorzystanie. Przy 429 odczekaj liczbę sekund z Retry-After.

{
  "error": {
    "code": "insufficient_scope",
    "message": "This endpoint requires reports:read."
  }
}

API odczytuje zapisane wyniki. Usunięcie raportu z konta usuwa także jego dostępność przez API. Unieważnienie lub wygaśnięcie klucza blokuje następne żądania; rozpoczęte mogą się zakończyć.