Referens

Takt och tak

Anrop per minut, sökkvot, tak på antal bolag per dygn, månadstak, dygnstak per nyckel och Idempotency-Key.

Gränserna skyddar dig mot oväntade kostnader, till exempel en AI-agent som fastnar i en loop, och tjänsten mot nedladdning av registret. De gäller både REST och MCP, och både live och test.

Gräns	Värde	Fel
Anrop per nyckel eller OAuth-anslutning	120 per minut	`429 rate_limited`
Anrop per konto	600 per minut	`429 rate_limited`
Sökningar per konto	1 000 per dygn	`429 search_quota_exceeded`
Olika bolag och personer per konto	2 000 per dygn som standard. Varje person vars engagemang du hämtar räknas som ett	`429 entity_cap_exceeded`
Kostnad per konto och månad (månadstak)	1 000 kr som standard	`402 monthly_cap_reached`
Kostnad per nyckel och dygn	Valfritt, sätts per nyckel	`402 key_daily_cap_reached`
Saldo	Dina krediter	`402 insufficient_credits`

Anrop per minut#

Takten räknas per kalenderminut. Svaret 429 har headern Retry-After med antal sekunder till nästa minut. Sprid ut anropen i stället för att skicka dem i skurar.

Olika bolag per dygn#

Vi räknar hur många olika bolag kontot hämtar per dygn. Samma bolag igen samma dygn räknas inte en gång till. Taket finns för att API:t är till för uppslag per företag och urval, inte för att kopiera registret. Behöver ni ett högre tak för ett avgränsat urval, kontakta support@getbolag.se.

Månadstak och dygnstak per nyckel#

Månadstaket stoppar alla betalda anrop när kontots förbrukning för kalendermånaden når taket. Ett dygnstak per nyckel stoppar bara den nyckeln. Båda kontrolleras innan uppslaget görs, så ett stoppat anrop kostar ingenting.

Idempotency-Key#

Agenter och nätverk gör om anrop. Skicka headern Idempotency-Key med ett unikt värde per uppslag, till exempel ett UUID, och använd samma värde när du försöker igen. Görs exakt samma anrop (samma operation och samma bolag) om med en nyckel vars första anrop lyckades, debiteras det inte igen. Du får svaret på nytt med cost_sek: 0.

bash

curl -s "http://localhost:3020/api/v1/companies/569900-0013/roles" \
  -H "Authorization: Bearer $GETBOLAG_KEY" \
  -H "Idempotency-Key: 3f1c2a9e-7d4b-4c55-9a51-0b6f1f7f2d10"

Använd aldrig samma Idempotency-Key för två olika uppslag. Det andra anropet avvisas då med 422 idempotency_key_reused och lämnar inte ut någon data. Ett anrop som slutade med fel eller inte hittat räknas inte som lyckat: görs det om och hittar något, debiteras det som vanligt.

Vad ett dygn är#

Dygns- och månadsgränser följer kalendern och nollställs vid midnatt respektive månadsskiftet.