SEO API
Screpy SEO API to interfejs REST umożliwiający przenoszenie danych projektu, crawlu, Rank Tracker, zapisanej widoczności AI, stron, monitoringu i szans do własnych produktów, paneli oraz automatyzacji. Używaj uporządkowanych odpowiedzi JSON do budowania procesów SEO na podstawie danych Screpy dostępnych dla Twojego konta.
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.
/projectsJSONAuthorization: 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.
/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.
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.
- 1WeryfikacjaOtwarte
/guides - 2WygenerowanoOtwarte
/shop - UkończonoOczekuje
example.com
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.
/guides/seo200
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.
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.
linen shirt#11
Wyświetlenia
2860Zarzą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.
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.
example.com [1]
example.org [2]
example.org/guidesexample.net/researchAnalizuj 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.
- example.org
- example.net
- example.edu
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.
disavow.txtWeryfikacjadomain: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.
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.
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.
- Screpy: Cześć! Przyjrzyjmy się SEO API dla example.com. Co chcesz wiedzieć?
- Ty: Wymień moje projekty Screpy i otwórz podsumowanie example.com.
- Screpy: Wybierz example.com i sprawdź ostatni ukończony crawl oraz dostępne dane. Asystent ma dostęp tylko do projektów dostępnych dla Twojego konta Screpy. Kontekst projektu: Projekt: example.com. Crawl: Ostatnie ukończone uruchomienie.
- Ty: Zamień to w krótki plan działania.
- Screpy: Oddzielę ustalenia od rekomendacji. Sprawdź dowody, wybierz jedną zmianę i później zweryfikuj wyniki. Twoje następne kroki: Sprawdź: Zweryfikuj źródło i datę każdego ustalenia.. Zdecyduj: Wybierz pierwszą zmianę.. Zweryfikuj: Porównaj wyniki po zmianie..
- Ty: Możesz wyjaśnić dowody prostymi słowami?
- Screpy: Tak. Zapytaj o obsługiwany wynik, a wyjaśnię, co pokazuje, skąd pochodzi i co pozostaje niepewne. Brakujące dane pozostają niedostępne; rekomendacje nie są automatycznymi poprawkami.
Pytania o SEO API.
Dowiedz się, jak REST API Screpy uwierzytelnia żądania, określa zakres projektów i crawli oraz udostępnia dane dla własnych produktów i automatyzacji SEO.
Kto może używać Screpy SEO API?
REST API Screpy jest dostępne dla płatnych kont członkowskich. Każde żądanie sprawdza uprawnienia konta, limity funkcji i dostęp do wybranego projektu.
Jak znaleźć UID projektu i crawlu?
Zacznij od GET /projects, aby wyświetlić projekty dostępne dla klucza. Użyj UID projektu z jego listą crawli, która zwraca UID crawlu do żądań danych.
Czym Screpy SEO API różni się od SEO MCP?
Screpy SEO API to REST API dla własnych produktów, paneli i automatyzacji uwierzytelnianych kluczem REST API. Screpy SEO MCP udostępnia uporządkowane narzędzia Screpy zgodnym asystentom AI przez OAuth i Model Context Protocol.
Czy mogę zarządzać Rank Tracker przez API?
Tak. API obsługuje przegląd Rank Tracker, listowanie i zarządzanie słowami, historię zapisanych analiz i wyników oraz podgląd i zarządzanie segmentami. Nie udostępnia eksportu CSV/XLSX ani bieżącego SERP.
Czy mogę pobierać Core Web Vitals i uptime przez API?
Tak. Core Web Vitals i uptime są dostępne przez osobne endpointy zdrowia, ponieważ wydajność i dostępność to różne sygnały. Odpowiedź data: null może oznaczać, że pasująca kontrola nie jest jeszcze dostępna.
Jak utworzyć klucz Screpy SEO API?
Utwórz klucz REST API w Ustawienia → Połączone aplikacje i wysyłaj go jako token bearer z każdym żądaniem. Dane OAuth MCP nie uwierzytelniają REST API Screpy.
Czy mogę używać AI Visibility przez API?
Tak. API odczytuje zapisane dane przeglądu AI Visibility, wzmianek, odpowiedzi, cytowań, promptów i źródeł oraz może dodawać lub miękko usuwać śledzone prompty. Eksport CSV i Excel pozostaje dostępny tylko w panelu.
Czy Screpy SEO API może porównywać crawle?
Tak. API porównań przyjmuje dwa zakończone odwołania do crawli i zwraca uporządkowane porównanie zmian między bazami.
Jakie dane crawlu może zwrócić Screpy SEO API?
Dla wybranego zakończonego crawlu REST API może zwrócić strony, linki, obrazy, ustalenia on-page i Quick Wins. Przy raportach zachowuj razem zakres projektu i crawlu.