Zespoły szukające API pozycji w Google zwykle chcą jednej konkretnej rzeczy: wywołania, które zwraca, na której pozycji znajduje się strona dla słowa kluczowego. Google tego nie publikuje.
To, co Google publikuje, to zestaw API opisujących Twoje własne wyniki, stan Twojego własnego indeksu i Twoją własną sytuację z indeksowaniem. Są naprawdę przydatne i wszystkie są darmowe. Są też strukturalnie niezdolne do odpowiedzi na pytanie, z którym większość ludzi przychodzi do tego wyszukiwania.
Spędziliśmy dzień, mierząc, co te API faktycznie zwracają na żywej usłudze, w tym części łatwe do błędnego odczytania. Trzy ustalenia się wyróżniły: dane przychodzą z trzydniowym opóźnieniem, liczba pozycji to średnia, której nie da się odtworzyć wobec wyniku na żywo, a jedyne API, które brzmi najbardziej jak sprawdzanie pozycji, zwraca werdykt, który sam w sobie nie mówi nic przydatnego.
Co Google faktycznie publikuje
Cztery powierzchnie bywają mylone z API pozycji. Oto do czego służy każda z nich, według dokumentacji samego Google.
Search Analytics API zwraca kliknięcia, wyświetlenia, CTR i średnią pozycję dla zweryfikowanej usługi. To najbliższa rzecz do danych o pozycjach, jaką oferuje Google, i źródło każdej liczby „średnia pozycja" w Search Console.
URL Inspection API zwraca stan indeksu dla pojedynczego adresu URL: czy Google o nim wie, czy jest zaindeksowany, a jeśli nie, to dlaczego.
Indexing API brzmi, jakby zgłaszał strony do indeksowania. Dokumentacja Google ogranicza obsługiwane typy do danych strukturalnych JobPosting i BroadcastEvent, co jest wąskim przypadkiem użycia, a nie ogólnym zgłaszaniem do indeksu.
Custom Search JSON API zwraca wyniki wyszukiwania dla zapytania. Przeszukuje indeks, który konfigurujesz samodzielnie, i nie mówi Ci, na której pozycji znajduje się Twoja witryna w głównych wynikach Google.
Żadne z nich nie zwraca „Twojej pozycji dla tego słowa kluczowego". Takiego zadania nie ma w ofercie Google, a jego brak jest zamierzony, nie przypadkowy. Google nie ma powodu handlowego, by rozdawać na dużą skalę dane o pozycjach konkurencji.
Co zmierzyliśmy: dane mają trzy dni
Pobraliśmy dzienny podział dla naszej własnej usługi 12 września 2026 roku. Najnowsza data z jakimikolwiek danymi to 9 września.
Dostępna data | Zwrócone wiersze |
|---|---|
2026-09-02 | jest |
2026-09-03 | jest |
2026-09-04 | jest |
2026-09-05 | jest |
2026-09-06 | jest |
2026-09-07 | jest |
2026-09-08 | jest |
2026-09-09 | jest, najnowsza |
Trzy dni opóźnienia, konsekwentnie. Parametr window liczy wstecz od najnowszej dostępnej daty, a nie od dzisiaj, i to mała pułapka: żądanie siedmiu dni zwraca osiem dat kończących się 9 września, a nie 12 września.
Dla raportu miesięcznego to nieistotne. Dla pytania „czy wczorajsza zmiana na stronie coś zepsuła" to dyskwalifikacja. Żadna konfiguracja tego nie naprawi. Opóźnienie jest po stronie Google.
Co zmierzyliśmy: średnia pozycja to nie pozycja
To ważniejsze ustalenie i to ono każe ludziom wierzyć, że API pozycji w Google istnieje i tylko się wymyka.
Średnia pozycja to średnie położenie Twojego adresu URL we wszystkich wyświetleniach w danym okresie, ważone przez kraje, urządzenia i warianty zapytania. Sprawdzenie pozycji na żywo zwraca jedną liczbę, z jednej lokalizacji, na jednym urządzeniu, w jednym momencie. To dwa różne pomiary dzielące jedną nazwę.
Sprawdziliśmy tę rozbieżność na 25 zapytaniach pobranych z naszych własnych danych Search Console, a następnie sprawdziliśmy te same 25 słów kluczowych wobec wyników na żywo dla Stanów Zjednoczonych, po angielsku, na komputerze, na głębokości 100.
Wynik | Liczba |
|---|---|
Zapytania użyteczne w obu zbiorach | 23 |
Pojawiły się w pierwszej setce na żywo | 14 (61%) |
Miały wyświetlenia w Search Console, ale brak odtwarzalnego wyniku na żywo | 9 (39%) |
Mediana różnicy bezwzględnej, gdy istniały oba | 7,4 pozycji |
Średnia różnica bezwzględna | 8,5 pozycji |
Największa różnica | 36,6 pozycji |
W granicach 3 pozycji od siebie | 4 z 14 |
Różnica większa niż 10 pozycji | 4 z 14 |
Tam, gdzie istnieją oba pomiary, rozchodzą się o medianę 7,4 pozycji.
Dwa szczegóły są ważniejsze niż średnie.
Po pierwsze, dziewięć z 23 zapytań dało pozycję w Search Console, ale w ogóle brak wyniku na żywo w sprawdzeniu dla Stanów Zjednoczonych, po angielsku, na komputerze. To nie błąd. Wyświetlenia zbierają się z innych krajów, innych języków, innych urządzeń oraz powierzchni obrazów i wideo. Pojedyncze sprawdzenie ograniczone do jednego obszaru ich nie odtworzy, a zespół, który traktuje obie liczby jak ten sam pomiar, spędzi tydzień na gonieniu rozbieżności, która jest artefaktem metody.
Po drugie, kierunek nie jest stały. Większość pozycji na żywo wypadła poniżej średniej z Search Console, czego należy oczekiwać, gdy średnia obejmuje lepiej wypadające powierzchnie. Ale jedno zapytanie przesunęło się o 36,6 pozycji w drugą stronę, z 73,6 na 37. Nie ma tu żadnego współczynnika korekty do zastosowania.
Różnica biegnie w obu kierunkach, więc nie ma współczynnika korekty do zastosowania.
Praktyczna konsekwencja dla każdego, kto wybiera API pozycji w Google: darmowe dane nie podadzą pozycji, a dane płatne się z nimi nie zgodzą. Oba poprawnie mierzą różne rzeczy. Traktowanie jednego jako zamiennika drugiego to punkt, w którym raportowanie się psuje.
Miejsce, w którym strona pierwsza jest naprawdę niezastąpiona, to pokrycie, które zmierzyliśmy osobno w porównaniu alternatyw dla API SERP.
Co zamiast tego zwraca URL Inspection API
URL Inspection API to jedyna powierzchnia Google, która przypomina sprawdzanie pozycji, bo podajesz jej adres URL bez słowa kluczowego i dostajesz z powrotem status. Sprawdziliśmy dwa adresy.
Stan adresu URL | Werdykt | Stan pokrycia | Czas ostatniego indeksowania |
|---|---|---|---|
Opublikowany około godziny wcześniej | NEUTRAL | Adres nieznany Google | Nieznany |
Opublikowany około dziewięciu godzin wcześniej | NEUTRAL | Wykryty, obecnie niezaindeksowany | Nieznany |
Oba zwróciły ten sam werdykt. Polem, które faktycznie odróżnia te dwa przypadki, jest łańcuch stanu pokrycia, a to zdanie, nie enumeracja. Pole werdyktu mówi NEUTRAL zarówno dla adresu, którego Google nigdy nie widział, jak i dla adresu wykrytego, ale niezaindeksowanego.
To użyteczne API i słaby sygnał monitorujący sam w sobie. Jeśli chcesz alertu, gdy strona nie jest zaindeksowana, analizuj stan pokrycia, a nie werdykt, i licz się z tym, że czasu ostatniego indeksowania zabraknie dokładnie przy tych adresach, na których zależy Ci najbardziej.
Cztery powierzchnie i zadanie, którego nie wykonuje żadna z nich
Pytanie | Powierzchnia Google | Odpowiedź |
|---|---|---|
Jak wypadłem dla tego zapytania w zeszłym tygodniu | Search Analytics API | Tak, z trzydniowym opóźnieniem, jako średnia |
Czy ten adres jest zaindeksowany | URL Inspection API | Tak, na adres, na żądanie |
Na której pozycji jestem teraz dla dowolnego słowa kluczowego | brak | Nie |
Na której pozycji są moi konkurenci | brak | Nie |
Jak wyglądają wyniki dla słowa, na które się nie pozycjonuję | brak | Nie |
Wzorzec jest spójny. API Google opisują Twoją usługę od środka. Pytanie o pozycję zadaje się z zewnątrz, o stronę wyników, a Google tego nie udostępnia.
Jak zasypać lukę, nie przepłacając
Praktyczny układ to dwa źródła o różnych zadaniach, a nie jedno źródło, od którego wymaga się obu rzeczy naraz.
Używaj API Google jako prawdy podstawowej o własnej usłudze. Kliknięcia, wyświetlenia i stan indeksu to fakty pierwszej strony, których nie zdobędziesz nigdzie indziej, i są darmowe. Pobieraj je według harmonogramu i traktuj trzydniowe opóźnienie jako właściwość samego przyrządu pomiarowego.
Używaj źródła SERP do spojrzenia z zewnątrz. Pozycje na żywo, pozycje konkurencji i słowa kluczowe, na które jeszcze się nie pozycjonujesz. To część płatna i jest tańsza, niż zakłada większość zespołów: w naszym teście sprawdzenie 23 słów kluczowych na głębokości 100 kosztowało $0,2975, czyli $0,0129 za sprawdzenie.
Nie próbuj godzić obu liczb. Mierzą różne rzeczy. Przydatnym ruchem jest czytanie ich razem: Search Console mówi, co się stało, a sprawdzenie na żywo mówi, co się dzieje. Gdy się rozchodzą, spójrz na skład krajów i urządzeń dla tego zapytania, zanim cokolwiek wywnioskujesz.
Mechanika uruchamiania obu z jednego skryptu jest w naszej budowie trackera z dwóch źródeł, a strona kosztowa połowy na żywo jest wyceniona w teście masowego sprawdzania.
Częste pytania
Czy Google ma oficjalne API pozycji? Nie. Google publikuje API dla Twoich własnych wyników wyszukiwania (Search Analytics), stanu indeksu (URL Inspection) i dwóch wąskich typów zgłaszania (Indexing). Żadne nie zwraca pozycji dla słowa kluczowego.
Dlaczego Search Console pokazuje pozycję, jeśli nie ma API pozycji? Bo średnia pozycja to metryka wyników obliczana z Twoich wyświetleń, a nie odpytywanie o pozycję. To średnie położenie we wszystkich wyświetleniach w okresie, uśrednione po krajach, urządzeniach i powierzchniach.
Jak bardzo opóźnione są dane Search Console? O trzy dni w naszym pomiarze 12 września 2026 roku, przy czym najnowsza dostępna data to 9 września. Parametr window liczy wstecz od tej daty, więc żądanie siedmiu dni zwraca osiem dat kończących się na najnowszym dostępnym dniu.
Czy URL Inspection API powie mi, czy strona jest zaindeksowana? Tak, i to właściwe narzędzie do tego zadania. Czytaj łańcuch stanu pokrycia, a nie pole werdyktu, bo werdykt zwraca NEUTRAL zarówno dla nieznanego adresu, jak i dla wykrytego, ale niezaindeksowanego.
Czy Custom Search JSON API to API pozycji? Nie. Zwraca wyniki z wyszukiwarki, którą konfigurujesz samodzielnie, a nie Twoją pozycję w głównych wynikach Google.
Jaki jest najtańszy sposób zdobycia prawdziwych danych o pozycjach? Sprawdzaj najmniejszy zestaw słów kluczowych, na którym faktycznie działasz, na głębokości odpowiadającej temu, gdzie się pozycjonujesz. Sprawdzenia na głębokości 10 kosztowały w naszym teście $0,002 za słowo kluczowe, a na głębokości 100 — $0,014, więc ustawienie głębokości rusza rachunkiem siedem razy mocniej niż liczba słów kluczowych.
Spojrzenie Auspia: uczciwa odpowiedź na pytanie „czy istnieje API pozycji w Google" brzmi nie, a przydatnym ciągiem dalszym jest przestać go szukać. API Google dobrze odpowiadają na pytania pierwszej strony i w ogóle nie potrafią odpowiedzieć na pytania o pozycje. Zaplanuj niewielką kwotę na spojrzenie z zewnątrz, a resztę wysiłku przeznacz na to, czego Google za Ciebie nie zrobi, czyli na decyzję, co zmienić, gdy obie liczby się rozchodzą.
Autor: Gabriel Finch, badacz wydobywania informacji w wyszukiwaniu, przegląd ponad 1 200 odpowiedzi AI w Auspia. Materiały o infrastrukturze wyszukiwania, systemach wydobywania i o tym, co każdy zestaw danych faktycznie widzi.
