Wprowadzenie
Dzięki Ahrefs API możesz wykorzystywać dane z przestrzeni roboczej Ahrefs do tworzenia niestandardowych integracji i automatyzacji. Obecnie API v3 umożliwia pobieranie danych z punktów końcowych Site Explorer, Keywords Explorer, Przegląd SERP, Rank Tracker, Site Audit, Brand Radar i Social Media Management, a także zarządzanie projektami Rank Tracker oraz listami Keywords Explorer:
- Site Explorer: Statystyki ogólne i historyczne wykresy, linki zwrotne, raporty dotyczące ruchu organicznego i płatnego
- Keywords Explorer: Metryki dla pojedynczego słowa kluczowego lub listy słów kluczowych, historia wolumenu wyszukiwań i wolumen według kraju, raporty z pomysłami na słowa kluczowe
- Site Audit: Oceny kondycji projektów, pełne raporty o problemach oraz treść zindeksowanych stron
- Przegląd SERP: 100 najlepszych wyników SERP
- Rank Tracker: Przegląd projektu, raporty konkurencji oraz SERP-y Rank Tracker
- Batch Analysis: Metryki dla maksymalnie 100 celów na jedno zapytanie
- Brand Radar: Statystyki przeglądu marki, historyczne wykresy skuteczności oraz rzeczywiste prompty z cytowaniami w wielu agentach AI
- Zarządzanie mediami społecznościowymi: Kanały, posty, historia aktywności i metryki dla połączonych kont w mediach społecznościowych
- Zarządzanie: Endpointy do zarządzania projektami Rank Tracker i listami Keywords Explorer
- Informacje o subskrypcji: Twoje limity API i wykorzystanie
- Publiczne endpointy: Adresy IP i zakresy adresów IP naszego robota indeksującego
Uprawnienia
Ahrefs API jest dostępne w ramach kwalifikujących się płatnych planów. We wszystkich pozostałych planach nadal będziesz mieć dostęp do ograniczonego zestawu bezpłatnych zapytań testowych.
Limity planu
Wszystkie żądania, z wyjątkiem bezpłatnych zapytań testowych oraz endpointów Rank Tracker, Management, Public i niektórych innych, zużywają jednostki API. Koszt zależy od liczby wierszy w odpowiedzi oraz żądanych pól. Minimalny koszt każdego żądania to 50 jednostek. Jeśli endpoint jest bezpłatny, na jego stronie dokumentacji zobaczysz odpowiednią adnotację; w przeciwnym razie zużywa jednostki.
Powiązany przewodnik: Zużycie jednostek
info
Należy pamiętać, że zużyte jednostki API nie podlegają zwrotowi. Zdecydowanie zachęcamy do korzystania z naszych bezpłatnych zapytań testowych do wszelkich prac programistycznych i testów, aby ograniczyć ryzyko niezamierzonego zużycia jednostek API.
Zalecamy również ustawienie limitów dla kluczy API, szczególnie na etapie testów i tworzenia.
Uprawnione płatne plany obejmują miesięczny limit jednostek API. W planach obsługujących model pay-as-you-go dodatkowe jednostki są naliczane automatycznie po przekroczeniu limitu wliczonego w plan.
Jeśli masz subskrypcję roczną, możesz zaoszczędzić, płacąc z góry za większą liczbę jednostek API po obniżonej cenie. Zużycie jednostek API możesz śledzić i kupować przedpłacone dodatki w Ustawienia konta / Limity i użycie.
Zobacz też: Strona z cenami

Klucze API
Aby wysyłać zapytania do Ahrefs API, potrzebujesz klucza API. Tylko właściciele obszaru roboczego oraz administratorzy mogą tworzyć i zarządzać kluczami API. Można to zrobić w Ustawienia konta / Klucze API.
Powiązany poradnik: Tworzenie i zarządzanie kluczami API
Podstawowe użycie
Zacznij szybko, korzystając z przycisków API w Raportach Ahrefs. Kliknij je, aby wyświetlić zapytanie jako polecenie cURL.

Tych przycisków można używać jak kreatora zapytań, ponieważ polecenie cURL będzie aktualizowane dynamicznie wraz z każdym filtrem zastosowanym w raporcie.
Pamiętaj, że cURL zawiera wszystkie pola i metryki widoczne w bieżącym raporcie. Możesz usunąć pola, których nie potrzebujesz, aby obniżyć koszt zapytania.
Aby poznać pełne szczegóły dotyczące użycia, zapoznaj się z naszą dokumentacją referencyjną API w tych dokumentach. Zawiera ona specyfikację zgodną z OpenAPI dla formatu zapytań i odpowiedzi każdego endpointu.
Ograniczanie szybkości
Ahrefs API jest domyślnie ograniczone do 60 zapytań na minutę. Po przekroczeniu tego limitu API zwróci kod statusu HTTP 429 (Too Many Requests).
Dodatkowo, aby utrzymać optymalną wydajność i stabilność systemu, zapytania API mogą być czasami odrzucane z tym samym kodem statusu HTTP 429 z powodu throttlingu. Throttling jest stosowany dynamicznie na podstawie bieżącego obciążenia systemu, dostępności zasobów oraz wymagań obliczeniowych Twoich zapytań.