Docs
Szukaj w dokumentacji...⌘K

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:

  1. Użyj select, aby pobierać tylko potrzebne pola: większość endpointów pozwala wskazać pola.
  2. Ogranicz liczbę wierszy: użyj limit lub równoważnych parametrów. Unikaj pobierania tysięcy wierszy, jeśli nie jest to konieczne.
  3. Gdzie to możliwe, używaj endpointów zbiorczych: na przykład batch-analysis pozwala pobrać metryki dla wielu stron w ramach jednego żądania.
  4. Pozwól użytkownikom monitorować wykorzystanie: endpoint limits-and-usage pokazuje, ile jednostek im pozostało.