Przewodnik po API
Pełny, szczegółowy opis API v3 znajdziesz tutaj: dokumentacja Ahrefs API. Ta strona to krótkie wprowadzenie dla deweloperów Ahrefs Connect.
Co możesz zrobić dzięki API v3
Ahrefs API v3 pozwala pobierać szeroki zakres danych, w tym:
- Dane organiczne i Linki zwrotne z Site Explorer (dla Twojej witryny lub konkurencji)
- Metryki i pomysły na słowa kluczowe z Keywords Explorer
- Dane z SERP Google
- Dane z projektów Rank Tracker i Site Audit użytkownika
- I więcej — regularnie dodajemy nowe punkty końcowe
Jednostki API i koszty żądań
Wszystkie żądania — z wyjątkiem bezpłatnych zapytań testowych oraz punktów końcowych Rank Tracker, Management, Public i kilku innych — zużywają jednostki API z konta podłączonego użytkownika.
Zasady naliczania kosztów:
- Zależy od liczby zwróconych wierszy oraz żądanych pól
- Minimalny koszt każdego płatnego żądania: 50 jednostek
- Jeśli punkt końcowy jest bezpłatny, jest to oznaczone na jego stronie dokumentacji
Podczas programowania
Jak wyjaśniono w Jak to działa, gdy Twoja aplikacja zostanie utworzona po raz pierwszy, będzie mieć status Nieaktywna. W tym trybie możesz testować procesy OAuth i wysyłać bezpłatne żądania testowe do punktów końcowych API v3 ze swojego środowiska testowego, bez zużywania jednostek. Gdy Twoja aplikacja zostanie zatwierdzona i aktywowana, żądania produkcyjne będą zużywać jednostki zgodnie ze standardowymi zasadami naliczania kosztów.
Dowiedz się więcej: Bezpłatne zapytania testowe oraz Zużycie limitów API
info
Dobre praktyki, aby oszczędzać jednostki API użytkowników
Wysyłając żądania w imieniu użytkowników, miej na uwadze ich miesięczny limit.
Oto jak zminimalizować zużycie jednostek:
- Użyj
select, aby pobierać tylko potrzebne pola: większość endpointów pozwala wskazać pola. - Ogranicz liczbę wierszy: użyj
limitlub równoważnych parametrów. Unikaj pobierania tysięcy wierszy, jeśli nie jest to konieczne. - Gdzie to możliwe, używaj endpointów zbiorczych: na przykład
batch-analysispozwala pobrać metryki dla wielu stron w ramach jednego żądania. - Pozwól użytkownikom monitorować wykorzystanie: endpoint
limits-and-usagepokazuje, ile jednostek im pozostało.