API & webhooks

REST API

Bizzzle exponerar ett REST API (v1) som returnerar JSON. Alla anrop autentiseras med en API-nyckel som skickas i headern Authorization: Bearer DIN_API_NYCKEL.

Bas-URL: https://bizzzle.se/api/v1

Fullständig API-dokumentation finns under /utvecklare i appen.

Skapa API-nyckel

1. Logga in i Bizzzle.
2. Gå till Inställningar → Utvecklare.
3. Klicka Skapa API-nyckel.
4. Ge nyckeln ett namn (t.ex. "CRM-integration") och klicka Skapa.
5. Kopiera nyckeln — den visas bara en gång.

Endpoints

• GET /api/v1/companies — Lista och filtrera företag. Stöder paginering, branschkod och geografi. Starter+ får även epost och telefon (företagets SCB-registrerade kontaktuppgifter).
• GET /api/v1/companies/:orgnr — Hämta ett enskilt företag med fullständig data, inklusive financials (omsättning, resultat) och digital (teknografi, sociala medier) för Starter+.
• GET /api/v1/companies/:orgnr/contacts — Hämta styrelsemedlemmar (namn och roll) för ett företag. Returnerar publika uppgifter från årsredovisningar — inte AI-berikade personkontaktuppgifter. Företagets egen e-post och telefon finns på /companies/:orgnr.
• GET /api/v1/companies/:orgnr/tech — Detaljerad teknografi: CMS, e-handel, betalning, analytics, marketing, hosting m.m.
• POST /api/v1/companies/bulk — Hämta upp till 100 företag i ett anrop.
• GET /api/v1/search?q=... — Fritextsökning bland företag.
• GET /api/v1/usage — Visa din nuvarande förbrukning och kvarvarande kvot (daglig + månatlig).
• GET /api/v1/filters/branches — Hämta branschkoder.

Företagskontakt vs. personkontakter

Företagets e-post och telefon (SCB-registrerade) returneras på /companies och /companies/:orgnr för Starter och högre. Explorer-nycklar får enbart boolean-indikatorer (harEpost, harTelefon).

/contacts returnerar styrelsemedlemmar (namn + roll) från publika årsredovisningar. AI-berikade personkontaktuppgifter (e-post, telefon, LinkedIn) exponeras inte via API:et.

Finansiell data

/companies/:orgnr returnerar ett financials-objekt (Starter+) med rå siffror i SEK från senaste bokslutet:

• rakenskapsarSlut — slutdatum för räkenskapsåret
• nettoomsattning — nettoomsättning i SEK
• rorelseresultat — rörelseresultat efter avskrivningar
• resultatForeSkatt — resultat före skatt
• aretsResultat — årets resultat

Teknografi (digital-objektet)

/companies/:orgnr och /companies/:orgnr/tech returnerar teknik-arrayer samt två metadata-fält (Starter+):

• observedAt — tidsstämpel (ISO 8601) för när teknik-observationen senast uppdaterades.
• techConfidence — ackumulerad detektions-styrka per teknik (heltal), inte en procent. Detektionen matchar mönster i HTML, headers och scripts — varje matchande mönster bidrar med sin poäng och poängen summeras per teknik:

• 100 = en signal matchade
• 200–300 = 2–3 oberoende signaler
• 400+ = fyra eller fler mönster (t.ex. WordPress)
• Under 100 (50/75/95) = en enda svagare/partiell match

Tolka relativt: högre värde = fler oberoende belägg = säkrare detektion.

Branschkoder (SNI / NACE)

Fältet branschKod är en 5-siffrig SNI 2025-kod (Svensk Näringsgrensindelning). SNI är kompatibel med EU:s NACE Rev. 2.1 — de första 4 siffrorna är identiska. Den 5:e siffran är en svensk precisering.

Detaljerat företagssvar inkluderar även nace (branschKod trunkerad till 4 siffror) för internationella integratörer.

Rate limits

API:et har tre lager av hastighetsbegränsning:

1. Per IP (middleware)

100 anrop per 60 sekunder per IP-adress, oavsett API-nyckel. Vid överskriden gräns: 429 Too Many Requests med headern Retry-After: 60.

2. Per API-nyckel (daglig + månatlig)

3. Kolla din kvot

GET /api/v1/usage returnerar din nuvarande förbrukning, kvarvarande kvot och tidpunkt för nästa reset.

Alla lyckade API-svar inkluderar dessutom rate-limit-headers:

• X-RateLimit-Limit — månatlig gräns
• X-RateLimit-Remaining — kvarvarande anrop denna månad
• X-RateLimit-Reset — Unix-timestamp för nästa månadsskifte

Webhooks

Webhooks skickar HTTP POST-notifieringar till en URL du anger när specifika händelser inträffar i Bizzzle. Det gör att ert system kan reagera i realtid utan att behöva polla API:et.

Konfigurera en webhook

1. Gå till Inställningar → Utvecklare → Webhooks.
2. Klicka Lägg till webhook.
3. Ange en HTTPS-URL som tar emot anropet.
4. Välj vilka händelser som ska trigga notifieringen.
5. Spara — Bizzzle skickar en test-ping för att verifiera att URL:en svarar med 2xx.

Tillgängliga händelser

• deal.created — Ny deal skapad.
• deal.updated — Deal uppdaterad (stage, värde etc.).
• deal.won — Deal markerad som vunnen.
• deal.lost — Deal markerad som förlorad.
• contact.unlocked — Ny kontakt upplåst via Contact Finder.
• customer.created — Ny kund tillagd.