Hoppa till innehåll
Firmainfo Docs API v1 för svenska företagsdata
API-referens OpenAPI Driftstatus
Meny och API-referens

Guide

Integrationsmönster

Exempel på hur API-resurser kan kombineras i vanliga B2B-flöden.

1. Onboarding av företagskunder

Låt kunden ange organisationsnumret en gång. Hämta sedan registerfälten automatiskt och kontrollera att verksamheten fortfarande är aktiv.

  • GET /companies/{id} ger namn, adress, status och skatteregistreringar.
  • GET /companies/{id}/history visar rapporterade insolvensförfaranden och tidigare namn.
  • GET /companies/{id}/financials/latest ger senaste rapporterade storlek och soliditet.

2. Urval och berikning

Börja med ett smalt segment och hämta mer data först för företag som verkligen är intressanta.

  • GET /companies?county=…&sni=…&revenue_min=…&sort=revenue skapar grundurvalet.
  • GET /companies/{id}/web kompletterar med verifierad webbplats och LinkedIn.
  • GET /companies/{id}/contact hämtar e-post när planen har kontaktutrymme.
  • GET /companies/{id}/workplaces visar lokal närvaro och huvudkontor.

Ta alltid hänsyn till advertising_block. Gränsen för unika företag är dimensionerad för riktade urval och löpande integrationer, inte för att kopiera hela registret.

3. Bevakning av en företagsportfölj

Kombinera insynshandel och blankning med din egen lista över företag och instrument.

  • Polla GET /changes?dataset=insider_transactions&after=… med ett intervall som passar din produkt.
  • Spara sidmarkören efter en lyckad körning och fortsätt därifrån nästa gång.
  • Skapa egna larm för köp med direction=buy och ett relevant min_value.
  • Använd GET /market/insider-summary?days=30 för en snabb nettobild per företag.
python 
# Enkel bevakningsloop: hämta allt nytt sedan förra körningen.
cursor = load_saved_cursor()          # None första gången
params = {"dataset": "insider_transactions", "limit": 200}
if cursor:
    params["cursor"] = cursor
else:
    params["after"] = "2026-08-01"

while True:
    page = session.get(f"{BASE}/changes", params=params, timeout=30).json()
    handle(page["data"])
    if not page["has_more"]:
        break
    params = {"dataset": "insider_transactions", "limit": 200, "cursor": page["next_cursor"]}

save_cursor(page["next_cursor"])

4. Företags- och varumärkesbevakning

  • GET /changes?dataset=insolvency&after=… hittar nya insolvensobservationer.
  • GET /changes?dataset=new_companies&after=… visar nya företag i ett löpande flöde.
  • GET /trademarks/changes?kind=expiring&until=… hittar märken som närmar sig förfallodatum.
  • GET /trademarks?query=… söker efter märken som liknar ett bevakat namn.

Rekommendationer för produktion

  • Cacha stabil registerdata när samma företag läses ofta. Ett dygn är en rimlig utgångspunkt.
  • Håll cachetiden kort för marknadsflöden där värdet ligger i färskheten.
  • Logga X-Request-Id tillsammans med ditt eget korrelations-id för snabb felsökning.
  • Lägg /status i övervakningen så att du kan skilja ett källproblem från ett fel i den egna integrationen.