Dla programistów i partnerów

API

Sprawdzenia z aplikacji uruchamiasz we własnych narzędziach i procesach. JSON na wejściu i wyjściu, klucze przypisane do projektu, a koszt każdego płatnego wywołania w odpowiedzi.

Dostępne w becie

Content Risk Scanner

Wysyłasz adres URL, HTML strony albo sam tekst. Dostajesz raport zgodności z zasadami spamowymi i kryteriami jakości Google, z cytatami ze strony i listą zmian.

Wybierasz rodzaje audytu: potencjalny spam, kryteria quality rater, helpful content albo wszystkie trzy.
Każda uwaga ma siłę sygnału od 0 do 100. Na życzenie dostaje też cytaty ze strony i poprawkę dla tej strony.
Jedna strona w wywołaniu albo mała paczka w jednym zapytaniu. Raporty po angielsku albo po polsku.
Każdy raport jest zapisany. Otworzysz go później w aplikacji albo pobierzesz plan „Jak to poprawić” jako Markdown lub JSON.

Dostępne w becie

Sprawdź tekst przed publikacją

Do artykułu gościnnego albo sponsorowanego. Wysyłasz tekst z linkami przed publikacją, a adres wydawcy jako kontekst.

Ani sprawdza anchory linków, notkę o autorze i język reklamowy.
Cytaty i „Jak to poprawić” są w cenie sprawdzenia.
Plan poprawek dla autora pobierzesz jako Markdown albo JSON i prześlesz dalej.

Dostępne w becie

Audyty witryn

Sprawdzasz w tle wiele stron jednej witryny albo wysyłasz własną listę stron.

Wybierasz strony albo działy do sprawdzenia i widzisz cenę przed startem.
Audyt możesz zapisać jako szkic i uruchomić później.
Wyniki jako JSON, CSV, HTML, PDF albo ZIP z jednym plikiem Markdown na stronę. Plan „Jak to poprawić” dla witryny pobierzesz jako Markdown albo JSON.
Podpowiedź content pruning dla każdej strony (Keep, Improve, Merge, Remove, Review) i plik CSV z linkami wewnętrznymi.

Dostępne w becie

Taxonomy Labeling

Przypisuje stronom i tekstom kategorie z IAB Content Taxonomy 3.1, Google Content Categories v2 albo z obu list.

Wysyłasz tekst, HTML albo adres URL. Stronę spod adresu Ani pobiera sama, a JavaScript renderuje tylko na Twoją prośbę.
Każda kategoria ma siłę sygnału od 0 do 100. Twój własny identyfikator wraca w odpowiedzi bez zmian.
Duże paczki są przetwarzane w tle, z wynikami w CSV i opcjonalnym webhookiem. Bezpłatna wycena pokazuje najpierw cenę.
Ani dopasowuje stronę do listy kategorii opublikowanej przez Google. To nie jest klasyfikacja wykonana przez Google.

Dostępne w becie

Search Intent

Wysyłasz frazę i rynek. Ani pokazuje intencję stojącą za frazą i to, jak Twoja strona wypada na tle czołowych wyników.

Wybierasz analizę intencji, analizę czołowych wyników albo porównanie z Twoją stroną.
Jedna fraza w zapytaniu albo wiele fraz jako JSON lub plik CSV, z eksportem całej paczki do CSV.
Wykorzystanie wcześniejszych wyników wyszukiwania może obniżyć cenę nowej analizy intencji.

Jak zacząć

Utwórz klucz w panelu deweloperskim albo w zakładce Klucze API projektu. Wybierz zakresy, datę wygaśnięcia i, jeśli chcesz, adresy IP, z których wolno go używać. Klucz widać tylko raz. Możesz go wymienić z okresem przejściowym albo w każdej chwili unieważnić.
Wyślij próbne zapytanie w playgroundzie. Playground uruchamia prawdziwe sprawdzenie na Twojej sesji albo wklejonym kluczu i pokazuje zapytanie, odpowiedź JSON, status i koszt.
Przeczytaj dokumentację: szybki start w curl, Pythonie i JavaScripcie oraz pełny opis API wygenerowany z aktualnego opisu OpenAPI.

Podłączasz agenta AI? Dokumentacja ma indeks llms.txt, każdą stronę w czystym Markdownie i przykładowe instrukcje, z którymi agent pyta człowieka przed każdym płatnym wywołaniem.

Jak odbierać wyniki

Webhooki. Właściciel albo administrator organizacji dodaje adres w panelu deweloperskim. Gdy audyt witryny jest gotowy, pod ten adres trafia podpisane zdarzenie (HMAC-SHA256 ze znacznikiem czasu). W panelu jest zdarzenie testowe, dziennik dostarczeń i ponowne wysłanie.
Sprawdzanie stanu. Praca w tle odpowiada nagłówkiem Retry-After, więc Twoja integracja wie, ile odczekać przed kolejnym zapytaniem.
Ponowienia. Obsługiwane endpointy mogą przez 24 godziny zwrócić zapisaną odpowiedź dla tego samego Idempotency-Key. Warunki i postępowanie po błędzie opisuje dokumentacja.
Błędy. Błędy mają stałe kody, które obsłużysz w swojej integracji.

Ile kosztują wywołania API

Wywołania API mają te same ceny co sprawdzenia w aplikacji i korzystają z tego samego salda. Nie ma osobnego planu API ani opłat za stanowiska.

Nagłówek X-Cost-USD pokazuje opłatę albo kwotę zarezerwowaną przy rozpoczęciu pracy w tle.
Za nieudaną pracę nie płacisz. Odczyt zamówionego raportu jest bezpłatny.
Limity wydatków dla organizacji, projektu i osoby widać na stronie Limity w panelu deweloperskim.

Ceny za stronę, tekst i frazę są w cenniku.

Endpointy, pola i kody błędów: dokumentacja API.