Hastighetsgränser

Förstå hastighetsgränser och kvoter för din API-nivå.

Översikt

FöretagsAPI implementerar hastighetsbegränsning för att säkerställa rättvis användning och API-stabilitet. Gränser tillämpas per API-nyckel och varierar beroende på prenumerationsnivå.

Hastighetsgränser (Rate Limits)

Hastighetsgränser styr hur många förfrågningar per minut du kan göra och skalar med din plan.

Plan	Hastighet
Gratis	Standardhastighet
Starter	5× snabbare
Pro	10× snabbare

Standardhastigheten räcker gott för löpande sökningar och uppslag. Bulk-endpoints returnerar dessutom många företag per förfrågan, så i praktiken kan du hämta tusentals företag på några sekunder även på lägre nivåer. Din exakta gräns returneras alltid i svarsheadern x-ratelimit-limit, och x-quota-remaining visar hur mycket av månadskvoten som återstår.

Mer kommer

Vi publicerar mer detaljerade gränser per endpoint inom kort.

Utan API-nyckel (gäst)

Endpointarna /v1/search och /v1/bulk går att anropa även helt utan API-nyckel. Då körs anropet i gästläge med en lägre hastighetsgräns. Svaret märks med "mode": "guest" i metadata, och svarsheadrarna visar x-ratelimit-tier: guest med x-ratelimit-limit: 30 förfrågningar per minut.

Gästläget är tänkt för snabb utvärdering och demo. För högre gränser, månadskvot och tillgång till alla endpoints, skapa ett konto och använd en API-nyckel.

Månadskvot (Krediter)

Månadskvoten begränsar hur många företag du kan slå upp per månad. Varje företag som returneras förbrukar 1 kredit.

Nivå	Månadskvot
Free	500 krediter/månad
Starter	5 000 krediter/månad
Pro	50 000 krediter/månad

Engångsköp av krediter

Utöver månadsprenumerationer kan du köpa engångskrediter: 10 000 krediter som engångsköp (giltiga i 12 månader). Besök prissidan för mer information.

Skillnad mellan hastighetsgränser och månadskvot

⚡ Hastighetsgränser

Hur snabbt du kan göra förfrågningar. Mäts i förfrågningar per minut. Om du överskrider gränsen får du ett 429-fel och måste vänta.

📊 Månadskvot

Hur mycket data du kan hämta. Mäts i antal företag (krediter) per månad. Varje returnerat företag förbrukar 1 kredit från din kvot.

Headers för hastighetsgränser och kvoter

Varje API-svar inkluderar headers för att hjälpa dig spåra din användning:

Header	Beskrivning
x-ratelimit-limit	Maximalt antal förfrågningar tillåtna per minut för din nivå
x-ratelimit-tier	Namnet på din nuvarande prenumerationsnivå (t.ex. "free", "starter", "pro")
x-quota-limit	Din totala månadskvot (antal krediter)
x-quota-remaining	Återstående krediter denna månad
x-quota-used	Antal krediter som använts denna månad

Exempel på svarsheaders

text

x-ratelimit-limit: 50
x-ratelimit-tier: free
x-quota-limit: 500
x-quota-remaining: 400
x-quota-used: 100

Felkoder (429 vs 402)

API:et använder olika statuskoder för att skilja mellan hastighetsgränser och kreditproblem:

Statuskod	Betydelse	Åtgärd
429	Rate limit - för många förfrågningar per minut	Vänta 60 sekunder och försök igen
402	Krediter slut	Uppgradera plan eller köp fler krediter

Hastighetsgränsfel (429)

När du överskrider hastighetsgränser får du ett 429 Too Many Requests-svar:

json

{
  "error": "För många förfrågningar",
  "message": "Du skickar förfrågningar för snabbt. Vänta några sekunder innan du försöker igen.",
  "retryAfter": 5
}

Svaret inkluderar också en retry-after-header med antal sekunder att vänta.

Hantering av hastighetsgränsfel

retryAfter är en vägledning om minsta väntetid, inte en garanti - i praktiken kan det ta längre tid (ofta upp till omkring 30 sekunder) innan gränsen återställs. Använd därför retryAfter som utgångspunkt och lägg på exponentiell backoff för automatiska omförsök i stället för att försöka igen exakt efter den angivna tiden.

Kreditfel (402)

När dina krediter är slut får du ett 402 Payment Required-svar:

json

{
  "error": "Krediterna är slut. Uppgradera din plan eller köp fler krediter."
}

Skillnad mot 429

Ett 402-fel indikerar att dina krediter är slut och att du behöver uppgradera din plan eller köpa fler krediter. Till skillnad från 429-fel hjälper det inte att vänta - du måste utöka din kvot.

Bästa praxis

1. Implementera exponentiell backoff

När du får ett 429-fel, börja med att vänta minst den tid som anges i retryAfter och öka sedan väntetiden med exponentiell backoff. Räkna med att full återställning kan ta längre än det angivna värdet (ofta omkring 30 sekunder).

2. Använd bulk-endpoints

Istället för att göra enskilda förfrågningar, använd bulk-uppslagsendpointen för att hämta flera företag i en enda förfrågan.

3. Cacha svar

Företagsdata ändras inte ofta. Cacha svar för att minska antalet API-anrop.

4. Övervaka din användning

Kontrollera hastighetsgränsheaders i svaren för att spåra din användning och undvika att nå gränserna.

Behöver du högre gränser?

Om du behöver högre hastighetsgränser eller större månadskvoter, överväg att uppgradera din nivå. Besök prissidan för att se priser och uppgradera din prenumeration.