SEO API

Twórz własne raporty SEO i automatyzacje dzięki uporządkowanym danym JSON z projektów Screpy. Pobieraj wyniki skanów, pozycje słów kluczowych, backlinki, zapisane AI Visibility i monitoring przez REST API o zakresie projektu, korzystając z obsługiwanych operacji do zarządzania pracą.

Przeczytaj przewodnik po API Utwórz konto Screpy

Lista dostępnych projektów

                GET https://api.screpy.com/v1/projects
Authorization: Bearer YOUR_API_KEY

{
  "data": [{
    "uid": "a1b2c3d4e5",
    "name": "Example Site",
    "domain": "example.com",
    "crawler_enabled": true,
    "created_at": "2026-09-24T09:00:00Z",
    "updated_at": "2026-09-24T09:00:00Z"
  }],
  "links": { "next": null },
  "meta": { "next_cursor": null }
}

Przykładowy fragment odpowiedzi. REST wymaga płatnego konta członkowskiego; klucz zwraca tylko własne lub udostępnione projekty, do których masz dostęp.

Uwierzytelnij SEO API

Utwórz klucz REST w Ustawienia → Połączone aplikacje i wysyłaj go z serwera jako token bearer. Wybierz uprawnienia potrzebne integracji.

Klucze tylko do odczytu pobierają dane; klucze do odczytu i zapisu pozwalają także na obsługiwane zmiany.
Skopiuj sekret przy tworzeniu: jest wyświetlany tylko raz. Nie umieszczaj go w publicznym kodzie przeglądarki.
Unieważniaj klucze w Połączonych aplikacjach. Możesz mieć do 20 aktywnych kluczy; wygasają po roku.

Przeczytaj poradnik uwierzytelniania

GET/projectsJSON

Authorization: Bearer
••••••••••••••••••••••••

Sprawdź dostęp API

REST wymaga płatnego konta członkowskiego. Członkostwo w projekcie i dostęp projektu do funkcji również określają dostępne dane i działania.

Endpointy konta pokazują plan, funkcje i liczbę dostępnych projektów.
Raporty użycia obejmują limity funkcji, ale wykorzystane i pozostałe wartości są obecnie obliczane tylko dla własnych projektów.
Wartość użycia null oznacza brak danych, nie zerowe zużycie.

Poznaj endpointy konta

GET/projects200

{
  "data": [
    { "domain": "example.com" }
  ]
}

Zarządzaj projektami SEO

Wyświetl własne i udostępnione projekty, pobierz podsumowanie lub utwórz projekty w ramach limitu własnych projektów. Używaj zwróconych UID w kolejnych żądaniach.

Zmieniaj nazwy, preferencje rynku i strefy czasowej oraz obsługiwane ustawienia skanowania i monitoringu.
Zmiana domeny wymaga nowego projektu; zmiana ustawień nie przepisuje zakończonych wyników.
Tworzenie projektu sprawdza limit i poprawność witryny.
Projekt może usunąć wyłącznie jego właściciel.

Poznaj endpointy projektów

example.comProjekt

example.orgProjekt

example.netProjekt

Uruchamiaj skany witryny

Rozpocznij skan z uprawnieniem zapisu i zachowaj zwrócony UID skanu. Skan działa w tle: śledź jego status przed pobraniem wyników.

Trwający skan lub wyłączony crawler może uniemożliwić uruchomienie kolejnego.
Podsumowania i zbiory danych wymagają pomyślnie zakończonego skanu; niedokończone wyniki zwracają konflikt.
Przechowuj razem identyfikatory projektu i skanu podczas raportowania lub porównywania zapisów.

Poznaj endpointy skanów

1
Weryfikacja/guides
Otwarte
2
Wygenerowano/shop
Otwarte
Ukończonoexample.com
Oczekuje

Pobieraj dane skanowania SEO

Twórz raporty technicznego SEO z wybranego zakończonego skanu. Pobieraj szczegóły stron i ustalaj strony źródłowe linków oraz obrazów.

Strony zawierają status HTTP, tytuły, opisy, nagłówki, adresy canonical, głębokość skanu i czasy.
Rekordy linków pokazują cele, teksty kotwic, status nofollow i kontekst strony źródłowej.
Rekordy obrazów zawierają tekst alternatywny, wymiary, status pobrania i strony źródłowe.
Korzystaj z obsługiwanych filtrów pól i stronicowania; nie jest to pełny eksport HTML ani interfejs SQL.

Poznaj endpointy danych skanu

/guides/seo200

Zindeksowano

Porównuj projekty i skany

Porównuj podsumowania technicznego SEO między projektami lub zapisami zakończonych skanów. Zachowaj konkretne identyfikatory skanów, aby odtworzyć porównania.

Porównania przyjmują od dwóch do pięciu dostępnych projektów, wykorzystując ostatnie zakończone skany lub wybrane zapisy.
Porównanie dwóch skanów zwraca zmiany kondycji, stron i liczby problemów jako drugi wynik minus pierwszy.
To porównania podsumowań; pobierz osobno rekordy skanów, aby zbadać pojedyncze adresy URL.

Poznaj endpointy porównań

Przed62→Po87

Pobieraj SEO Quick Wins

Włącz priorytetowe możliwości do pracy wraz ze źródłem i okresem raportu. Identyfikator zakończonego skanu sprawdza dostęp, ale nie przypisuje każdej możliwości do tego skanu.

Przy dostępnych połączonych danych Search Console wskazuje zapytania bliskie wysokim pozycjom, CTR, kanibalizację, spadki i zmiany widoczności.
Ustalenia dotyczące linków wewnętrznych mogą opierać się na najnowszym skanie projektu wskazanym w metadanych.
Ustalenia wynikające z ruchu wymagają odpowiedniego połączenia, uprawnień i wystarczających danych.
Zachowaj typy raportów, daty, ostrzeżenia i dostępność; pusty raport nie dowodzi braku problemów.

Poznaj Quick Wins

linen shirt#11

Wyświetlenia

2860

Zarządzaj śledzeniem pozycji

Odczytuj zapisaną widoczność słów, historię analiz i wyniki pozycji z kontekstem rynku i urządzenia. Zarządzaj śledzonymi słowami zamiast pytać o dowolne wyniki wyszukiwania na żywo.

Filtruj słowa według wyszukiwania, urządzenia i segmentu opartego na URL, także bez dopasowania do segmentu.
Dodaj do 100 słów na żądanie; pierwsza analiza trafia do kolejki, bez natychmiastowego wyniku.
Usuwaj śledzone słowa oraz podglądaj, twórz, zmieniaj lub usuwaj segmenty z prawem zapisu.
REST nie udostępnia SERP na żywo, ręcznej ponownej analizy ani eksportu CSV/XLSX z Rank Tracker.

Poznaj endpointy Rank Tracker

Pozycje

+24 Pozycja

Korzystaj z AI Visibility

Łącz zapisane odpowiedzi AI ze wzmiankami o marce, cytowaniami i źródłami. Zachowaj kontekst promptu, kraju, języka i platformy we własnych raportach.

Odczytuj podsumowania, wzmianki, odpowiedzi, cytowania, śledzone prompty i aktywność domen lub URL źródłowych.
Dodaj do 20 promptów na żądanie w ramach limitu projektu lub usuń śledzone prompty z prawem zapisu.
Sugestie promptów, ręczna ponowna analiza i eksporty AI Visibility nie są operacjami REST.

Poznaj AI Visibility

example.com [1]
example.org [2]

1example.org/guides

2example.net/research

Analizuj backlinki

Odczytuj profil backlinków projektu lub wcześniej dodanego konkurenta wybranego z dostępnych opcji. Łącz linki z domenami odsyłającymi we własnych raportach autorytetu.

Pobieraj metryki podsumowania, domeny odsyłające i backlinki wybranej domeny.
Sprawdzaj luki backlinków oraz obsługiwane zbiory utraconych domen i domen z uszkodzonymi linkami.
Zachowaj cel, filtry, sortowanie i kursor; nie jest to nieograniczone wyszukiwanie dla dowolnej domeny.
Eksporty tabel CSV/XLSX obejmują bieżącą stronę. Kontynuuj przez X-Next-Cursor.

Poznaj Backlink Checker

example.org
example.net
example.edu

example.com84 Linki

Zarządzaj wpisami disavow

Przechowuj sprawdzone domeny lub URL z notatkami w projekcie, a następnie przygotuj plik tekstowy w formacie Google. Decyzje o zrzekaniu się linków podejmujesz samodzielnie.

Z prawem zapisu możesz dodać do 100 wpisów na żądanie lub usunąć istniejące rekordy.
Eksportuj tekst disavow projektu osobno od stronicowanych tabel.
Sprawdź i prześlij plik ręcznie; zapisanie rekordu nie wysyła go do Google ani nie usuwa backlinka.

Poznaj Disavow Management

disavow.txtWeryfikacja

domain:example.org
https://example.net/links

Domenaexample.org
URLexample.net/links

Odczytuj kondycję witryny

Oddzielaj wydajność stron od dostępności witryny w raportach. Endpointy zwracają istniejące kontrole, nie nowe pomiary na żądanie.

Wydajność obejmuje ostatnio sprawdzoną stronę główną z FCP, LCP, CLS, TTFB, TBT i Speed Index, nie każdą stronę ani pełną historię.
Uptime podsumowuje ostatnie 30 dni i zwraca do 160 najnowszych kontroli ze statusem, czasem odpowiedzi i datą.
Brak wydajności to data:null; bez kontroli uptime wartości podsumowania pozostają null, a lista jest pusta.

Poznaj endpointy kondycji

example.comLaboratorium

LCP2,1 s
TBT180 ms
CLS0,04

Stronicuj dane SEO

Pobieraj większe zbiory w wygodnych porcjach i zachowuj kontekst żądania w przetwarzaniu. Sprawdź dostępność przed zamianą odpowiedzi w metrykę panelu.

Obsługiwane listy domyślnie zwracają 50 rekordów, maksymalnie 100; używaj kolejnych linków lub nieprzezroczystych kursorów.
Zachowuj te same filtry, cele i okresy między stronami. Nieprawidłowe parametry są odrzucane.
Obsługuj jawnie błędy autoryzacji, nieukończonego skanu, niedostępnych danych i limitów żądań zamiast zastępować brakujące wyniki zerem.

Przeczytaj poradnik błędów API

JSONcursor_2

Porozmawiaj o SEO API. Z SEO MCP.

Połącz asystenta z projektem Screpy przez SEO MCP. Wybierz projekt, sprawdź podsumowanie i analizuj obsługiwane dane crawla, pozycji i wyszukiwania z ograniczonym zakresem dostępu.

Poznaj Screpy SEO MCP Połącz asystenta AI

Pytania o SEO API

Praktyczne odpowiedzi dotyczące dostępu REST, danych i niezawodnej integracji.

Jakie są limity żądań API?

Na minutę limit podstawowy wynosi 300 żądań na klucz i 900 na konto. Ciężkie endpointy dodatkowo dopuszczają 60 na klucz i 180 na konto; endpointy zapisu 30 i 90. Kontrole obowiązują łącznie. Obsłuż HTTP 429 i ponów po dozwolonym czasie oczekiwania.

Czym różnią się SEO API i SEO MCP?

SEO API służy tworzonemu przez Ciebie oprogramowaniu przez żądania REST i klucz bearer REST. SEO MCP udostępnia obsługiwane narzędzia zgodnym asystentom AI przez Model Context Protocol i własną autoryzację. Dane dostępowe MCP nie uwierzytelniają REST, a dostępne operacje nie są identyczne.

Czy REST udostępnia wszystkie funkcje panelu?

Nie. Dokumentacja API wymienia obsługiwane operacje REST. Nie ma endpointów REST dla wyników Map Tracker, tworzenia artykułów, raportów PDF ani wszystkich surowych danych analitycznych. Rank Tracker i AI Visibility mają również opisane powyżej ograniczenia działań i eksportów.

Czy mogę eksportować dane API do CSV lub Excela?

Endpointy tabel backlinków obsługują CSV/XLSX bieżącej strony z X-Next-Cursor do kontynuacji. Tekst disavow ma osobny eksport. Eksporty CSV/XLSX Rank Tracker i AI Visibility pozostają w panelu; inne uporządkowane odpowiedzi mogą zasilać własny kod raportowania.

Jak znaleźć UID projektu i skanu?

Wywołaj GET /projects, wybierz dostępny projekt i pobierz jego listę skanów. Używaj razem zwróconych UID projektu i skanu. Endpointy podsumowań i danych wymagają pomyślnie zakończonego skanu.

Czy brak danych oznacza brak problemów SEO?

Nie. Wartości null, puste rekordy, ostrzeżenia i błędy dostępności mają różne znaczenia. Brak pomiaru wydajności nie oznacza awarii witryny, a niedostępne użycie nie oznacza zerowego zużycia. Sprawdź odpowiedź i konfigurację przed wyciągnięciem wniosków.

Czy klucz tylko do odczytu działa z każdym POST?

Nie. Porównania POST projektów i skanów akceptują odczyt, ponieważ analizują istniejące dane. Tworzenie lub zmienianie rekordów, uruchamianie skanów i podgląd segmentów wymaga odczytu i zapisu. Sprawdzaj udokumentowane uprawnienia zamiast wnioskować z metody HTTP.

Czy wszystkie wyniki API są aktualne lub na żywo?

Nie. Rekordy skanów należą do wybranego zapisu; pozycje i AI Visibility korzystają z zapisanych analiz. Quick Wins zależy od źródła i okresu raportu. Endpointy kondycji zwracają istniejące kontrole. Zachowaj dostępne daty i kontekst źródeł w raportach.