API-dokumentation

Prospektly API

Programmatisk tillgång till Sveriges mest kompletta företagsdatabas. Tillgänglig via RapidAPI och APILayer.

Endpoints

GET

/api/v2/foretag

Sök och filtrera svenska företag. Returnerar 50 resultat per sida, max 200 sidor (10 000 träffar) per sökning — smalna av med fler filter för att nå resten.

GET

/api/v2/foretag/{org_nummer}

Hämta ett enskilt företag med fullständig data via organisationsnummer.

Filterparametrar

Parameter	Typ	Beskrivning
search	string	Fritext — söker i namn, org_nummer och domän
ort	string	Filtrera på stad (t.ex. Stockholm, Göteborg)
organisationsform	string	AB, HB, EF, KB etc.
harWebbplats	ja \| nej	Filtrera på om företaget har webbplats
harEmail	ja \| nej	Filtrera på om företaget har e-post
techstack	string	Filtrera på teknik (t.ex. Shopify, WordPress)
sni	string	SNI-branschkod (t.ex. 62010)
anstallda	string	Storleksklass anställda (t.ex. 10-49)
omsattning	string	Storleksklass omsättning (t.ex. 10-49 mnkr)
page	number	Sidnummer, 1–200 (default: 1)

Kodexempel

cURL

curl -X GET "https://prospektly.com/api/v2/foretag?ort=Stockholm&harEmail=ja&page=1" \
  -H "X-RapidAPI-Key: DIN_NYCKEL" \
  -H "X-RapidAPI-Host: prospektly-api.p.rapidapi.com"

JavaScript (fetch)

const response = await fetch(
  "https://prospektly.com/api/v2/foretag?ort=Stockholm&harEmail=ja",
  {
    headers: {
      "X-RapidAPI-Key": "DIN_NYCKEL",
      "X-RapidAPI-Host": "prospektly-api.p.rapidapi.com",
    },
  }
);

const { data, total, page, totalPages } = await response.json();
console.log(`Hittade ${total} företag`);

Exempelsvar

{
  "data": [
    {
      "org_nummer": "556000-0000",
      "namn": "Exempel AB",
      "organisationsform": "AB",
      "adress_ort": "Stockholm",
      "webbplats": "https://exempel.se",
      "domain": "exempel.se",
      "anstallda": "10-49",
      "omsattning": "10-49 mnkr"
    }
  ],
  "total": 4821,
  "page": 1,
  "totalPages": 97
}

Rate limiting

Din månadskvot styrs av planen du valt på marknadsplatsen, som skickar med hur mycket du har kvar i sina egna X-RateLimit-*-headers. Utöver kvoten finns en gräns för hur många requests du får göra per minut — överskrids den svarar vi HTTP 429 med en Retry-After-header som anger hur många sekunder du bör vänta.

HTTP/1.1 429 Too Many Requests
Retry-After: 38

Felkoder

400

Bad Request

Ogiltig parameter — t.ex. page utanför intervallet 1–200.

401

Unauthorized

API-nyckeln saknas eller är ogiltig.

403

Forbidden

Åtkomsten till API:et är tillfälligt spärrad.

404

Not Found

Företaget med det angivna org_nummer hittades inte.

429

Too Many Requests

För många requests — sänk anropstakten och försök igen.

Redo att börja?

Skaffa din API-nyckel via RapidAPI eller APILayer.

Kom igång via RapidAPI Kom igång via APILayer