POST/v1/bulk

Bulkuppslag

Slå upp flera företag i en enda förfrågan.

Översikt

Bulkuppslag-endpointen låter dig slå upp flera företag på namn i en enda API-förfrågan. Detta är mer effektivt än att göra flera individuella förfrågningar när du behöver slå upp flera företag samtidigt.

Batchgränser

Autentiserade förfrågningar: Maximalt 100 namn per förfrågan

Kreditförbrukning

Varje lyckad matchning förbrukar 1 kredit.

Exempel:

Du skickar 10 företagsnamn och alla hittas = 10 krediter
Du skickar 100 företagsnamn och 95 hittas = 95 krediter

Misslyckade uppslag (inga matchningar) förbrukar inga krediter.

Fuzzy-matchning

API:et använder fuzzy-matchning och returnerar alltid närmaste match. Kontrollera score-fältet för att bedöma matchningskvalitet:

score = 1.0: Exakt matchning
score > 0.8: Mycket god matchning
score < 0.6: Tveksam matchning - verifiera manuellt

Förfrågan

Förfrågningskropp

Skicka ett JSON-objekt med en array av företagsnamn:

json

{
  "names": ["Spotify AB", "Ericsson AB", "Skanska AB"]
}

Parametrar

Parameter	Typ	Obligatorisk	Beskrivning
names	array	Obligatorisk	Array med företagsnamn att slå upp. Maximalt 100 namn per förfrågan.

Kodexempel

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

curl

curl -X POST 'https://data.foretagsapi.se/v1/bulk' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"names": ["Spotify AB", "Ericsson AB", "Skanska AB"]}'

Svar

Lyckat svar (200 OK)

Returnerar ett JSON-objekt som innehåller en results-array med lyckat/misslyckat-status för varje uppslag:

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{
  "results": [
    {
      "searchTerm": "Spotify AB",
      "success": true,
      "company": {
        "id": 521294,
        "name": "Spotify AB",
        "orgNumber": "5567037485",
        "legalForm": "AB-ORGFO",
        "postalAddress": {
          "street": "Regeringsgatan 19",
          "city": "Stockholm",
          "postalCode": "11153"
        },
        "registrationDate": "2006-04-18",
        "score": 1.0
      }
    },
    {
      "searchTerm": "Ericsson AB",
      "success": true,
      "company": {
        "id": 123456,
        "name": "Telefonaktiebolaget LM Ericsson",
        "orgNumber": "5560000000",
        "legalForm": "AB-ORGFO",
        "score": 0.85
      }
    },
    {
      "searchTerm": "Unknown Company XYZ",
      "success": true,
      "company": {
        "id": 789012,
        "name": "XYZ Company AB",
        "orgNumber": "5560001234",
        "legalForm": "AB-ORGFO",
        "score": 0.51
      }
    }
  ],
  "metadata": {
    "totalSearches": 3,
    "successfulSearches": 3,
    "processingTimeMs": 150,
    "timestamp": "2024-01-15T10:35:00Z",
    "mode": "api"
  }
}

Svarsfält

Fält	Typ	Beskrivning
results	array	Array med resultatobjekt, ett för varje begärt namn
results[].searchTerm	string	Den ursprungliga söktermen från förfrågan
results[].success	boolean	Om en matchning hittades (alltid true med fuzzy-matchning)
results[].company	object	Företagsdata med närmaste matchning. Kontrollera score-fältet för matchningskvalitet.
results[].company.score	number	Matchningspoäng 0.0-1.0. Lågt värde (<0.6) indikerar osäker matchning.
results[].error	string	Felmeddelande (endast närvarande om success är false, sällsynt med fuzzy-matchning)
metadata.totalSearches	number	Totalt antal företagsnamn som begärdes i batchen
metadata.successfulSearches	number	Antal uppslag som returnerade ett matchande företag
metadata.processingTimeMs	number	Behandlingstid i millisekunder
metadata.timestamp	string	Tidsstämpel för förfrågan (ISO 8601-format)

Hantera osäkra matchningar

Med fuzzy-matchning returneras alltid närmaste match. Kontrollera alltidscore-fältet för varje resultat. Vid låga poäng (<0.6) bör du verifiera matchningen manuellt eller flagga den för granskning.

Felsvar

400 Bad Request

Returneras när förfrågan överskrider batchgränsen eller har ogiltigt format:

json

{
  "error": "Batch size exceeds limit. Maximum 100 names."
}