DataForSEO.com to jeden z zewnętrznych silników sprawdzania pozycji dostępnych w Stat4Seo. Platforma oferuje swoje usługi w modelu Pay-as-you-go, w którym użytkownik zasila swoje konto i płaci wyłącznie za faktycznie wykonane zapytania. Pełny cennik usługi Google Organic SERP API dostępny jest tutaj.
Jedno zapytanie odpowiada sprawdzeniu jednej strony wyników wyszukiwania Google dla konkretnej frazy. Oznacza to, że jeśli dana fraza znajduje się na pozycji 26, Stat4Seo musi pobrać wyniki z trzech stron (1., 2. i 3.), aby określić dokładną pozycję – w takim przypadku wykonane zostaną 3 zapytania.
W przypadku DataForSEO aplikacja Stat4Seo wysyła zapytania, które nie są realizowane natychmiast, lecz kolejkowane. Przy domyślnych ustawieniach wykorzystywana jest standardowa kolejka (Standard Queue), w której czas realizacji zapytania nie powinien przekroczyć 5 minut. Oznacza to, że po odświeżeniu pozycji w Stat4Seo wynik może pojawić się w ciągu kilku minut (czasem szybciej, czasem nieco później). W praktyce nie ma to znaczenia przy codziennym sprawdzaniu pozycji – można wysłać zapytania dla wszystkich fraz w krótkim czasie, a następnie poczekać na komplet wyników. Dzięki temu możliwe jest sprawdzenie nawet kilkuset fraz w ciągu kilkunastu minut.
Dostępna jest również kolejka priorytetowa (Priority Queue), która gwarantuje zwrócenie wyników w ciągu maksymalnie 1 minuty, jednak jej koszt jest około dwukrotnie wyższy.
Koszt zapytań w DataForSEO wynosi 0,0006 USD za sprawdzenie pojedynczej strony wyników Google,
Przykład:
jeśli dana fraza znajduje się na pozycji 26, Stat4Seo musi pobrać wyniki z trzech stron (1., 2. i 3.), co daje koszt 0,0006 * 3 = 0,0018 USD. Monitorowanie 500 takich fraz przez 30 dni wyniesie zatem: 0,0018 × 500 × 30 = 27 USD.
DataForSEO zapewnia bardzo wysoką precyzję danych oraz umożliwia monitorowanie map Google.
Instrukcja integracji
Aby zintegrować Stat4Seo z DataForSEO, należy najpierw zarejestrować konto w tym serwisie – można to zrobić, przechodząc pod ten link. Najczęściej należy wybrać opcję konta „Personal”.
W kolejnym kroku wybieramy „SERP Tracking” oraz „REST API”, zgodnie z poniższym zrzutem ekranu.
W kolejnym kroku wypełniamy ankietę dotyczącą tego kiedy planujemy integrację i jaką formę kontaktu preferujemy, wybieramy na przykład „ASAP” i „Email”, tak jak na zrzucie ekranu.
Po rejestracji trafisz na dashboard. Powinien też przyjść e-mail z linkiem do aktywacji konta. Jeżeli na górze widzisz żółty baner „Verify your account to start fetching data”, należy w niego kliknąć i potwierdzić swój numer telefonu lub adres e-mail.
Następnie można przejść do zakładki API Access. Jeżeli w sekcji API Credentials jest widoczne pole „Base64 Format” to kopiujemy znajdujący się tam klucz API. Jeżeli nie ma takiego pola, należy kliknąć przycisk przycisk „SEND BY E-MAIL” lub „RESET API PASSWORD”. Po jego kliknięciu na podany adres e-mail otrzymasz klucz API w formacie Base64 (Base64 Format) – skopiuj go z tej wiadomości.
Uzyskany klucz API wklej w swojej instalacji Stat4Seo w polu „Klucz API”, w zakładce Ustawienia → Silniki sprawdzania → Silnik sprawdzania DataForSEO.
Następnie przejdź do Ustawienia → Ustawienia monitorowania → Silnik sprawdzania i wybierz integrację z DataForSEO.
Po rejestracji otrzymujesz 1 USD środków startowych do wykorzystania. Po ich zużyciu należy zasilić konto dodatkowymi środkami – można to zrobić w panelu użytkownika DataForSEO w zakładce Add Funds.
Limity użycia i zabezpieczenia
Webhooki i usługi typu Cloudflare
Integracja Stat4Seo z DataForSEO działa w modelu asynchronicznym. Stat4Seo wysyła zapytania do API DataForSEO, które trafiają do kolejki przetwarzania. Po zakończeniu analizy (np. po kilku minutach) DataForSEO wysyła wynik w postaci webhooka — żądania POST — na adres URL Stat4Seo.
Jeżeli korzystasz z usług typu Cloudflare (lub innych firewalli / WAF / systemów ochrony przed botami), może się zdarzyć, że webhooki wysyłane przez DataForSEO zostaną zablokowane i potraktowane jako ruch automatyczny lub botowy. W takiej sytuacji Stat4Seo nie otrzyma wyników zapytań, mimo że po stronie DataForSEO zadania zostaną poprawnie wykonane i rozliczone. Oznacza to, że konto użytkownika w DataForSEO zostanie obciążone kosztami tych zadań, nawet jeśli ich wyniki nie dotrą do Stat4Seo z powodu zablokowania webhooków.
Aby temu zapobiec, należy dodać adresy IP wykorzystywane przez DataForSEO do tzw. whitelisty (allowlisty) w Cloudflare lub innym używanym systemie ochrony.
Aktualna lista adresów IP dostępna jest na stronie:
https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api
Po dodaniu tych adresów IP do whitelisty webhooki z DataForSEO powinny być poprawnie odbierane przez Stat4Seo.
Zabezpieczenia
Aby zabezpieczyć się przed nadmiernym zużyciem środków na koncie DataForSEO – na wypadek sytuacji jak opisanej powyżej (Cloudflare) lub błędów po stronie Stat4Seo, serwera lub samego DataForSEO — warto skorzystać z mechanizmów zabezpieczających udostępnianych przez DataForSEO.
W skrajnym przypadku, jeśli na koncie DataForSEO znajduje się np. 50 USD i wystąpi poważny błąd (np. aplikacja wpadnie w pętlę i zacznie masowo wysyłać zapytania), możliwe jest zużycie całego budżetu w bardzo krótkim czasie.
Ustawienia zabezpieczeń można skonfigurować po zalogowaniu się do konta DataForSEO, w zakładce Settings.
Duplicate tasks limit
Duplikaty zadań w DataForSEO to zadania z identycznym ładunkiem danych (payload). W kontekście Stat4Seo oznacza to wielokrotne sprawdzanie tej samej frazy w tej samej wyszukiwarce.
Po ustawieniu maksymalnej liczby zadań o identycznych parametrach, wszystkie kolejne duplikaty przekraczające ustalony limit w ciągu jednej godziny zostaną odrzucone i zwrócą błąd — bez generowania jakichkolwiek kosztów.
Zalecane jest ustawienie tego limitu na wartość np. 10.
Daily expenses limit
Jest to dzienny limit wydatków na koncie DataForSEO. Warto wcześniej oszacować:
- liczbę analizowanych fraz,
- przewidywany koszt zapytań,
- częstotliwość ich wykonywania.
Na tej podstawie należy ustawić limit dzienny na wartość nieznacznie wyższą od spodziewanego zużycia, co zapewni bufor bezpieczeństwa bez ryzyka niekontrolowanych wydatków.
Webhook delay
DataForSEO wysyła webhooki do Stat4Seo. Jeżeli będzie ich dużo, serwer gdzie mamy Stat4Seo może zablokować te zapytania ze względu na ich dużą ilość. W DataForSEO polecam ustawić minimalny odstęp między kolejnymi webhookami na 500ms. Można to zrobić w zakładce Settings, w polu Webhook delay.
