Dokumentacja dla deweloperów

Limity szybkości

DomScan API do analizy domen: Każda uwierzytelniona odpowiedź, udana lub z błędem, zawiera te nagłówki, a przeglądarki mogą je odczytać przez CORS.

Limity szybkości

  • Konta bezpłatne: 300 żądań na minutę z możliwością wzrostu do 60. Ten budżet jest wspólny dla wszystkich kluczy API i sesji pulpitu na koncie.
  • Konta płatne: 900 żądań na minutę z możliwością wzrostu do 120. Ten budżet jest wspólny dla wszystkich kluczy API i sesji pulpitu na koncie.
  • Plany Enterprise i miesięczne plany dużego wolumenu: Limity niestandardowe uzgodnione z naszym zespołem pod kątem Twojego obciążenia. Gdy taki limit jest aktywny, X-RateLimit-Policy zawiera custom oraz podaje uzgodnioną szybkość i wartość burst. Porozmawiaj z zespołem sprzedaży
  • Żądania bez klucza API: 600 żądań na minutę na adres IP, z burstem 20.
  • Punkty końcowe zbiorcze dla kont bezpłatnych: Dodatkowe 20 żądań na minutę na konto i 100 żądań na minutę na sieć.
  • Żądania z pamięci podręcznej (prefer_cache=1): Nadal liczone w stosunku do Twojego limitu szybkości, ale odpowiadają szybciej i pomijają wyszukiwanie upstream.
  • Punkt końcowy zbiorczy: 50 domen na żądanie
  • TLD na żądanie: maksymalnie 50
Przekroczenie limitu zwraca HTTP 429 z nagłówkiem Retry-After. Każda uwierzytelniona odpowiedź zawiera X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Policy, dzięki czemu możesz śledzić pozostały budżet zamiast zgadywać.

Nagłówki limitu zapytań

Każda uwierzytelniona odpowiedź, udana lub z błędem, zawiera te nagłówki, a przeglądarki mogą je odczytać przez CORS. Używaj ich do regulowania tempa żądań zamiast czekać na 429.

NagłówekCo oznacza
X-RateLimit-PlanKtóry limit obowiązuje: free, paid lub standard dla żądań bez klucza API.
X-RateLimit-LimitTwoja pojemność burst: ile żądań możesz wysłać naraz.
X-RateLimit-RemainingIle żądań możesz jeszcze teraz wysłać, zanim zadziała limit.
X-RateLimit-ResetCzas Unix w sekundach, w którym Twoja pojemność burst znów jest pełna.
X-RateLimit-PolicyPełna polityka w postaci czytelnej maszynowo, na przykład paid; sustained=900; burst=120; scope=account; window=60.
Retry-AfterWysyłany z HTTP 429: ile sekund czekać przed ponowną próbą.