POST/v1/sni/search

SNI-sökning

Sök efter företag baserat på deras SNI-kod (branschklassificering).

Översikt

SNI-sökning-endpointen låter dig hitta alla företag som har en specifik SNI-kod registrerad som en av sina affärsverksamheter. Du kan även filtrera på stad. Detta är användbart för marknadsundersökningar, konkurrentanalys eller för att hitta företag i en specifik bransch.

Flera SNI-koder

Svenska företag kan ha upp till 5 SNI-koder (sni1-sni5) registrerade. Denna sökning hittar företag där den angivna koden finns i något av dessa fält.

Resultatbaserad debitering

1 kredit = 1 returnerat företag.

Om du begär 100 företag och 47 hittas, debiteras du 47 krediter. Fältet creditsCharged i metadata visar alltid exakt vad som debiterades.

Skydd mot överförbrukning: Din limit begränsas automatiskt till din kvarvarande kvot. Du kan inte av misstag förbruka mer än du har.

Om stora resultatmängder

Populära SNI-koder som 62100 (Dataprogrammering) kan ha ~15 000 företag totalt. Använd paginering med offset för att hämta data i omgångar.

Förfrågan

Förfrågningskropp

Skicka ett JSON-objekt med SNI-koden att söka efter, samt valfria filter:

json

{
  "sni_code": "70200",
  "city": "Stockholm",
  "limit": 10
}

Parametrar

Parameter	Typ	Obligatorisk	Beskrivning
sni_code	string	Obligatorisk	5-siffrig SNI-kod (t.ex. "70200").
city	string	Valfri	Filtrera på stadsnamn (skiftlägesokänslig, partiell matchning).
limit	number	Valfri	Max antal företag per anrop. Standard: 100, Max: 100.
offset	number	Valfri	Pagineringsoffset. Standard: 0.

Paginering

Använd offset och limit för paginering. Fältet hasMore i svaret indikerar om fler resultat finns.

Kvoter och begränsningar

Plan	Månatlig kvot	Max resultat per anrop
Free	500 krediter	100 företag
Starter	5 000 krediter	100 företag
Pro	50 000 krediter	100 företag

Kodexempel

Här är exempel på flera programmeringsspråk:

curl

1
2
3
4
5# Sök företag med SNI-kod, filtrera på stad
curl -X POST 'https://data.foretagsapi.se/v1/sni/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"sni_code": "70200", "city": "Stockholm", "limit": 10}'

Svar

Lyckat svar (200 OK)

Returnerar ett JSON-objekt med matchande företag:

json

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51{
  "companies": [
    {
      "id": 123456,
      "name": "Konsultbolaget AB",
      "orgNumber": "5567012345",
      "legalForm": "AB",
      "postalAddress": {
        "street": "Storgatan 1",
        "postalCode": "11122",
        "city": "STOCKHOLM"
      },
      "registrationDate": "2015-03-15",
      "deregistrationDate": null,
      "deregistrationReason": null,
      "businessDescription": "Företagskonsulttjänster",
      "ongoingRestructuring": null,
      "ftgstat": 1,
      "jestat": null,
      "jurform": 49,
      "reklamsparr": 1,
      "sniCodes": {
        "sni1": "70200",
        "sni2": null,
        "sni3": null,
        "sni4": null,
        "sni5": null,
        "sni1_name": "Konsultverksamhet avseende företagsledning",
        "sni2_name": null,
        "sni3_name": null,
        "sni4_name": null,
        "sni5_name": null
      },
      "score": 1.0
    }
  ],
  "metadata": {
    "sniCode": "70200",
    "sniDescription": "Konsultverksamhet avseende företagsledning och företagsstyrning",
    "city": "Stockholm",
    "resultCount": 10,
    "totalCount": 4523,
    "offset": 0,
    "limit": 10,
    "hasMore": true,
    "creditsCharged": 10,
    "processingTimeMs": 230,
    "timestamp": "2026-01-29T12:00:00.000Z",
    "mode": "api"
  }
}

Metadata-fält

Fält	Typ	Beskrivning
sniCode	string	SNI-koden som söktes
sniDescription	string \| null	Beskrivning av SNI-koden
city	string \| null	Stadsfilter som användes (om angivet)
resultCount	number	Antal företag i detta svar
totalCount	number	Totalt antal matchande företag
offset	number	Aktuell pagineringsoffset
limit	number	Limit som användes
hasMore	boolean	True om fler resultat finns att hämta
creditsCharged	number	Antal krediter som debiterades
processingTimeMs	number	Bearbetningstid i millisekunder
timestamp	string	ISO 8601 tidsstämpel
mode	string	Alltid "api" för autentiserade anrop

Företagsfält

Varje företag i companies-arrayen innehåller:

Fält	Typ	Beskrivning
name	string	Företagets namn
orgNumber	string	10-siffrigt organisationsnummer
id	number	Internt databas-ID
legalForm	string	Juridisk form som textkod. Vanliga: AB-ORGFO (Aktiebolag), EF-ORGFO (Enskild firma), HB-ORGFO (Handelsbolag)
postalAddress	object	Objekt med street, postalCode, city
registrationDate	string	Registreringsdatum (YYYY-MM-DD)
deregistrationDate	string \| null	Avregistreringsdatum om företaget är avregistrerat
businessDescription	string	Verksamhetsbeskrivning
ftgstat	number	F-skattestatus (0=aldrig, 1=aktiv, 9=inaktiv)
reklamsparr	number	Reklamspärr (0=okänd, 1=ingen spärr, 2=spärrad)
jestat	number \| null	Status för juridisk enhet (1=aktiv, null=ej tillgänglig)
jurform	number \| null	Juridisk formkod (numerisk). Vanliga: 10=Enskild firma, 31=Handelsbolag, 49=Aktiebolag, 51=Ekonomisk förening
ongoingRestructuring	string \| null	Kod för pågående avveckling/rekonstruktion. Prefix: LI=likvidation, KK=konkurs, FR=företagsrekonstruktion. Null om inget pågår.
deregistrationReason	string \| null	Orsakskod vid avregistrering. Vanliga: KKAV-AVORG (konkurs), FUAV-AVORG (fusion), LIAV-AVORG (likvidation). Null om ej avregistrerat.
score	number	Matchningspoäng 0.0-1.0 (vid SNI-sökning baserat på relevans)
sniCodes	object	Upp till 5 SNI-koder med beskrivningar

SNI-koder objekt

json

{
  "sni1": "70200",
  "sni2": "62020",
  "sni3": null,
  "sni4": null,
  "sni5": null,
  "sni1_name": "Konsultverksamhet avseende företagsledning",
  "sni2_name": "Datakonsultverksamhet",
  "sni3_name": null,
  "sni4_name": null,
  "sni5_name": null
}

Användningsområden

Vanliga användningsområden för SNI-sökning inkluderar:

Marknadsundersökning: Hitta alla företag i en specifik branschsektor
Konkurrentanalys: Identifiera företag med liknande affärsverksamhet
Lead-generering: Bygg riktade listor för B2B-försäljning
Branschrapporter: Aggregera data för sektoranalys

Paginering

Använd offset och limit för att paginera. Fältet hasMore indikerar om fler resultat finns.

json

// Sida 1
{"sni_code": "70200", "limit": 100, "offset": 0}

// Sida 2
{"sni_code": "70200", "limit": 100, "offset": 100}

// Sida 3
{"sni_code": "70200", "limit": 100, "offset": 200}

Felsvar

Status	Fel	Orsak
400	Missing required parameter: sni_code	Ingen SNI-kod angavs
400	Invalid SNI code format. Must be 5 digits.	Koden är inte exakt 5 siffror
400	Threshold exceeded	SNI-koden har >5000 företag utan stadsfilter. Lägg till `city`-parameter.
405	Method not allowed	Använd POST, inte GET
429	Quota exceeded. Please upgrade your plan or wait for monthly reset.	Månatlig kvot uppnådd
500	Database error during search	Internt fel (försök igen)

Exempel på threshold-fel (400)

Returneras när SNI-koden har över 5000 företag och inget stadsfilter anges:

json

{
  "error": "Threshold exceeded",
  "message": "SNI-koden 70200 har 85 393 företag. Lägg till ett stadsfilter för att begränsa resultaten.",
  "requiresCity": true,
  "totalCount": 85393,
  "sniCode": "70200"
}

Exempel på kvotfel (429)

json

{
  "error": "Quota exceeded. Please upgrade your plan or wait for monthly reset."
}