Gå til hovedindhold
FirmaAPIFirmaAPI

Brugseksempel: salg

Find virksomheder og lav en leadliste

Find alle aktive virksomheder i en branche og et område, fx IT-virksomheder i Aarhus med mindst fem ansatte, og gem dem som en liste, du kan åbne i Excel eller indlæse i dit CRM. Et lille Python-script klarer søgning, sider og filen.

Det skal du bruge

find_virksomheder.py

Python-script, der finder virksomheder efter branche og område og gemmer dem som CSV.

Download

Du skal have Python 3.8 eller nyere. Har du ikke kørt et Python-script før, så se de første trin i guiden til kundelister.

Foretrækker du Excel? Excel-skabelonen har et ark, hvor du vælger de samme filtre og får både listen og en fordeling efter fx kommune eller branche, uden at køre et script.

Trin for trin

  1. Find din målgruppe. Slå branchekoden op på branchekoder, og beslut, hvilket område du vil dække: kommune eller postnummer.
  2. Sæt din API-nøgle i terminalen med $env:FIRMAAPI_KEY = "..." på Windows eller export FIRMAAPI_KEY="..." på Mac.
  3. Kør en søgning. Scriptet henter 100 ad gangen, indtil der ikke er flere eller grænsen i --max er nået. Standard er 200.

    Eksempler

    # IT-virksomheder i Aarhus med mindst 5 ansatte
    python find_virksomheder.py --branche 62 --kommune Aarhus --min-ansatte 5
    
    # Elinstallatører i postnummer 8000 stiftet efter 1. januar 2024
    python find_virksomheder.py --branche 4321 --postnr 8000 --stiftet-efter 2024-01-01
    
    # Restauranter i København med telefonnummer, op til 500 stk.
    python find_virksomheder.py --branche 5610 --kommune København --med-telefon --max 500 --ud restauranter.csv

    Det ser du

      Side 1: 100 virksomheder i alt
      Side 2: 200 virksomheder i alt
    Gemte 200 virksomheder i virksomheder.csv (2 opslag brugt).
  4. Åbn listen i Excel. Filen bruger semikolon og UTF-8, så den åbner direkte i en dansk Excel med æ, ø og å i behold.

Filtre i scriptet

ValgBetyderParameter i API'et
--branche 62Branchekode, virker som præfiksindustry
--kommune AarhusKommunenavn eller -kodemunicipality
--postnr 8000Postnummerzipcode
--virksomhedsform ApSFx ApS, A/S, IVS eller ENKcompany_type
--stiftet-efter 2024-01-01Kun nye virksomhederfounded_after
--min-ansatte 5Mindst så mange ansatteemployees_min
--med-telefon, --med-email, --med-hjemmesideKun virksomheder med kontaktoplysningenhas_phone
--medtag-reklamebeskyttedeTag også reklamebeskyttede medad_protected

Scriptet søger altid kun efter aktive virksomheder. API'et har flere filtre, fx region, omsætning og alder. Dem kan du tilføje i scriptet. De står i dokumentationen.

Kolonnerne i listen

CVR, navn, adresse, postnummer, by, kommune, virksomhedsform, branchekode, branche, ansatte, stiftelsesdato, telefon, e-mail, hjemmeside og om virksomheden er reklamebeskyttet. Telefon, e-mail og hjemmeside er kun med, hvis virksomheden selv har registreret dem i CVR.

Reklamebeskyttelse

En virksomhed kan i CVR frabede sig henvendelser med markedsføring. Scriptet udelader derfor reklamebeskyttede virksomheder, medmindre du skriver --medtag-reklamebeskyttede. Brug kun det valg, hvis listen ikke skal bruges til markedsføring, fx til en markedsanalyse.
  • Kolonnen Reklamebeskyttet viser Ja eller Nej, så du kan tjekke listen, før du bruger den.
  • Reglerne for e-mail og opkald til virksomheder gælder stadig. Reklamebeskyttelse er ikke det eneste, du skal tjekke.

Ofte stillede spørgsmål

Hvor mange opslag bruger en søgning?

Én søgning henter op til 100 virksomheder og tæller som ét opslag. En liste på 500 virksomheder koster altså 5 opslag. Med 1.000 gratis opslag om måneden kan du lave mange lister.

Må jeg kontakte virksomhederne på listen?

Det afhænger af, hvordan du kontakter dem og om hvad. Reklamebeskyttede virksomheder har frabedt sig henvendelser med markedsføring, og dem udelader scriptet som standard. Reglerne for direkte markedsføring gælder stadig, så tjek dem, før du sender e-mails eller ringer.

Hvordan finder jeg den rigtige branchekode?

Se listen over branchekoder på firmaapi.dk/branchekoder. Koden virker som et præfiks, så 62 finder alle IT-virksomheder, mens 620100 kun finder computerprogrammering.

Kan jeg få regnskabstal med på listen?

Søgningen kan filtrere på omsætning og egenkapital med revenue_min og capital_min. Felterne kan tilføjes i scriptet som ekstra parametre. Tallene i resultatet afhænger af din plan; regnskabsdata kræver Standard.

Prøv det med din egen API-nøgle

Opret en gratis konto, og hent din API-nøgle med det samme. Intet kreditkort kræves.