Jak korzystać z API Ahrefs i Semrush

Korzystanie z API Ahrefs i SEMrush bywa kluczem do zwiększenia efektywności pozycjonowania stron internetowych. Dzięki nim specjaliści zyskują dostęp do ogromnej bazy danych, automatyzują procesy oraz szybko reagują na zmiany w profilach linków czy trendach słów kluczowych. W kolejnych sekcjach omówimy krok po kroku, jak skonfigurować połączenie z oboma serwisami, jakie typy zapytań można wykonywać oraz w jaki sposób wykorzystać otrzymane wyniki do usprawnienia codziennej pracy w zakresie narzędzi SEO.

Integracja z API Ahrefs

Uzyskiwanie klucza i warunki dostępu

Aby rozpocząć pracę z API Ahrefs, należy posiadać aktywną subskrypcję oraz wygenerować klucz dostępu w panelu użytkownika. Po zalogowaniu się na konto, w menu wybieramy sekcję API, gdzie znajdujemy opcję “Create API token”. Po nadaniu nazwy i określeniu limitów wywołań otrzymujemy ciąg znaków, który będzie kluczem do autoryzacji. Warto pamiętać, że Ahrefs stosuje limity zapytań w zależności od wykupionego planu, dlatego przed zaplanowaniem masowej analizy należy sprawdzić, jaki mamy dzienny, tygodniowy i miesięczny przydział.

Podstawowe wywołania i parametr

Ahrefs API udostępnia wiele metod, m.in.:

  • backlinks – pobieranie listy backlinków do danej domeny lub URL;
  • refdomains – analiza liczby unikalnych domen odsyłających;
  • organic_keywords – słowa kluczowe dla serwisu w wynikach organicznych.

Przykładowe wywołanie HTTP GET może wyglądać tak:

https://apiv2.ahrefs.com?token=TWÓJ_KLUCZ&from=backlinks&target=twojadomena.pl&limit=100&output=json

W odpowiedzi otrzymamy strukturę JSON z listą linków, ich mocą referencyjną oraz dodatkowymi metadanymi, jak anchor text czy typ linku (follow/nofollow).

Integracja z API SEMrush

Rejestracja i konfiguracja klucza

Aby korzystać z SEMrush API, należy posiadać konto z aktywnym planem zawierającym dostęp do API. Po zalogowaniu w zakładce “My Profile” wystarczy przejść do “API Access” i wygenerować swój kod. Należy pamiętać, że SEMrush rozlicza się za punkty API, czyli w zależności od rodzaju raportu każdy endpoint zużywa określoną liczbę punktów. W panelu łatwo sprawdzimy saldo, historię zużycia oraz dostępne limity.

Rodzaje zapytań i przydatne parametry

Do najczęściej wykorzystywanych usług w SEMrush API należą:

  • domain_ranks – ocena widoczności domeny;
  • organic_search – analiza słów kluczowych konkurencji;
  • backlinks – pobieranie profilu linków przychodzących;
  • phrase_this – podpowiedzi long-tail dla wybranego wyrażenia.

Przykład wywołania:

https://api.semrush.com/?type=backlinks&key=TWÓJ_KLUCZ&target=twojadomena.pl&display_limit=50&export_columns=SourceURL,TargetURL,Anchor

Wynik przesyłany jest w formacie CSV lub JSON i zawiera szczegółowe informacje o każdym odnośniku, co pozwala na dalszą analizę w arkuszu kalkulacyjnym lub bezpośrednią integrację z systemami BI.

Wykorzystanie danych w procesie pozycjonowania

Monitorowanie profilu linków

Dzięki obu API można regularnie monitorować nowe i utracone backlinki. Automatyczne skrypty zapisujące zmiany w bazie umożliwiają porównanie stanu sprzed tygodnia i identyfikację wartościowych odnośników. Przy pomocy prostych komend SQL lub skryptów w Pythonie generujemy raporty, które informują nas o:

  • nowych linkach dodanych
  • usuniętych lub zdezawuowanych linkach
  • wartości Domain Rating (DR) / Authority Score (AS) odsyłających domen

Taka automatyzacja ułatwia szybką reakcję – na przykład wysłanie prośby o przywrócenie linku lub zgłoszenie niechcianych odnośników z niską reputacją.

Analiza słów kluczowych i konkurencji

SEMrush API umożliwia pozyskanie danych o ruchu organicznym konkurentów oraz propozycji nowych fraz. Dzięki temu możemy zbudować szeroką listę tematów contentowych, które mają potencjał generować dodatkowy ruch. W praktyce:

  • pobieramy top 50 słów kluczowych dla domeny konkurencji;
  • oceniamy ich wolumen, trudność i koszt CPC;
  • tworzymy rozbudowane zestawienia i mapy słów kluczowych.

Z kolei Ahrefs API pozwala szybko zweryfikować, które z tych fraz przyniosły realne dane na koncie naszej strony, usprawniając proces optymalizacji treści.

Automatyzacja raportów i powiadomień

Wykorzystując zadania CRON lub serwisy typu Zapier integrowane z Google Sheets, można w prosty sposób:

  • wysyłać cotygodniowe raporty o stanie SEO;
  • powiadamiać zespół o przekroczeniu progu nowych linków;
  • przekazywać alerty o znacznym spadku widoczności.

Cały proces opiera się na regularnych wywołaniach API, przetwarzaniu odpowiedzi oraz generowaniu przyjaznych wizualnie dokumentów. Dzięki temu każdy klient lub manager ma bieżący wgląd w wyniki prowadzonych działań.

Najlepsze praktyki i wskazówki

Ograniczanie zużycia punktów i limitów

Aby efektywnie zarządzać budżetem API, warto:

  • grupować zapytania zamiast wykonywać pojedyncze wywołania dla każdej strony;
  • stosować filtrowanie parametrów, aby pobierać tylko potrzebne dane;
  • planować wywołania w godzinach o mniejszym obciążeniu systemu, co może przyspieszyć odpowiedź serwera.

Zabezpieczenie kluczy i zgodność z politykami

Klucze API należy przechowywać w bezpiecznym miejscu (np. w menedżerze sekretów). W przypadku udostępniania kodu unikaj umieszczania wartości klucza bezpośrednio w repozytorium. Ponadto sprawdzaj na bieżąco regulaminy Ahrefs i SEMrush, ponieważ nowe limity lub zmiany w ofercie mogą wpływać na koszty i możliwości integracji.

Sposoby rozbudowy funkcjonalności

W miarę rozwoju projektów SEO można tworzyć własne moduły integrujące wyniki z systemami analitycznymi, CRM czy platformami e-commerce. Dzięki połączeniu danych z API obu serwisów uzyskujemy kompleksowy widok na profil linkowy, widoczność i potencjał słów kluczowych, co pozwala na podejmowanie decyzji opartych na obiektywnych wskaźnikach.