LinkedIn-bedrijfspagina’s vinden met Python en API

Gebruik Datablists Company to LinkedIn API om met Python vanaf een website de LinkedIn-bedrijfspagina te vinden. Je kunt een los domein of een volledige website-URL versturen, wachten tot de matchingtaak is afgerond en vervolgens de bedrijfsnaam, website, LinkedIn-bedrijfs-URL en een confidence-indicatie ontvangen.

In deze handleiding gebruik ik Python en de Requests-library om vijf bedrijfswebsites te matchen. De lijst bevat bekende softwarebedrijven, maar ook VAUDE, een fabrikant van outdooruitrusting, en Drooms, een aanbieder van virtual data rooms. Daarna verwerk ik de resultaten in twee lokale wachtrijen: matches die klaar zijn voor bedrijfsonderzoek en matches die handmatig moeten worden gecontroleerd.

🔑 Samenvatting voor wie weinig tijd heeft

Stuur de websites uit je accountlijst naar Datablists Company to LinkedIn API. De API retourneert URL’s van LinkedIn-bedrijfspagina’s en confidence-indicaties, zodat je kunt bepalen welke relaties je direct gebruikt en welke je eerst controleert.

Input: losse domeinen en volledige URL’s van bedrijfswebsites.

Output: bedrijfsnamen, gematchte websites, URL’s van LinkedIn-bedrijfspagina’s en een high of low confidence, verdeeld over de wachtrijen Ready for research en Needs review.

💡 Liever een no-code oplossing? Gebruik Datablists LinkedIn Company Pages & Domain Lookup om bedrijfswebsites en LinkedIn-pagina’s te matchen zonder code te schrijven.

Python en je Datablist API-key instellen

Voor dit voorbeeld gebruik ik het package requests. De API werkt via HTTP, dus je kunt dezelfde volgorde van requests later eenvoudig in een andere programmeertaal toepassen.

Je hebt een Datablist-account met toegang tot de REST API nodig. Die toegang is inbegrepen bij het Growth-abonnement. Geslaagde lookups verbruiken daarnaast enrichment credits. Verderop in deze handleiding leg ik de exacte berekening uit.

Maak een werkmap en een bestand met de naam find_linkedin_company_pages.py. Maak vervolgens een virtual environment aan en installeer Requests:

shell

1mkdir company-linkedin-matcher
2cd company-linkedin-matcher
3python -m venv .venv
4source .venv/bin/activate
5python -m pip install requests
6touch find_linkedin_company_pages.py

Maak via je Datablist-account een Personal API Key aan en exporteer deze als environment variable:

shell

1export DATABLIST_API_KEY="your-api-key"

Het script leest deze waarde uit en verstuurt hem in de X-API-Key-header.

LinkedIn-bedrijfspagina’s vinden met één Python-functie

Het voorbeeld gebruikt deze vijf bronaccounts:

account-datablist: datablist.com
account-posthog: posthog.com
account-n8n: https://n8n.io
account-vaude: vaude.com
account-drooms: https://www.drooms.com

Elke account_id wordt de inputId voor de API. Dat is belangrijk, omdat resultaten niet per se in dezelfde volgorde binnenkomen als de input. Met een stabiele ID kun je elk resultaat aan het juiste bronaccount koppelen.

Plak het volgende volledige script in find_linkedin_company_pages.py:

python

1import json
2import os
3import time
4import uuid
5
6import requests
7
8
9def match_companies(accounts, api_key, matching_direction):
10    """Submit one matching task, wait for it, and return every result."""
11    tasks_url = "https://api.datablist.com/v1/enrichments/tasks"
12    headers = {"X-API-Key": api_key}
13    inputs = [
14        {
15            "inputId": account["account_id"],
16            "data": {"sourceUrl": account["source_url"]},
17        }
18        for account in accounts
19    ]
20
21    unique_id = str(uuid.uuid4())
22    print(f"Task uniqueId: {unique_id}", flush=True)
23    payload = {
24        "enrichmentId": "company-to-linkedin",
25        "uniqueId": unique_id,
26        "settings": {"matchingDirection": matching_direction},
27        "inputs": inputs,
28    }
29    response = requests.post(tasks_url, headers=headers, json=payload)
30    response.raise_for_status()
31    task = response.json()
32    task_id = task["@id"]
33    task_url = f"{tasks_url}/{task_id}"
34
35    while task["status"] not in ("completed", "failed", "stopped"):
36        time.sleep(3)
37        response = requests.get(task_url, headers=headers)
38        response.raise_for_status()
39        task = response.json()
40
41    if task["status"] != "completed":
42        raise RuntimeError(
43            f"Task {task_id} {task['status']}: {task.get('error')}"
44        )
45
46    results = []
47    results_url = f"{task_url}/results"
48    params = {"limit": 100}
49    while True:
50        response = requests.get(results_url, headers=headers, params=params)
51        response.raise_for_status()
52        page = response.json()
53        results.extend(page["results"])
54        next_cursor = page["nextCursor"]
55        if next_cursor is None:
56            break
57        params["cursor"] = next_cursor
58
59    return results
60
61
62accounts = [
63    {
64        "account_id": "account-datablist",
65        "company_name": "Datablist",
66        "source_url": "datablist.com",
67    },
68    {
69        "account_id": "account-posthog",
70        "company_name": "PostHog",
71        "source_url": "posthog.com",
72    },
73    {
74        "account_id": "account-n8n",
75        "company_name": "n8n",
76        "source_url": "https://n8n.io",
77    },
78    {
79        "account_id": "account-vaude",
80        "company_name": "VAUDE",
81        "source_url": "vaude.com",
82    },
83    {
84        "account_id": "account-drooms",
85        "company_name": "Drooms",
86        "source_url": "https://www.drooms.com",
87    },
88]
89
90api_key = os.environ.get("DATABLIST_API_KEY")
91if not api_key:
92    raise RuntimeError("Set DATABLIST_API_KEY before running this script.")
93
94match_results = match_companies(
95    accounts, api_key, matching_direction="domain_to_linkedin"
96)
97print(json.dumps(match_results, indent=2))

Voer het script uit met:

shell

1python find_linkedin_company_pages.py

De functie doet achtereenvolgens drie soorten calls.

Eerst verstuurt de POST de vijf websites, met matchingDirection ingesteld op domain_to_linkedin. De API antwoordt met 202 Accepted en een taak-ID, omdat de matching als achtergrondtaak wordt uitgevoerd. Het Requests-script blijft toch sequentieel aanvoelen, omdat het wacht voordat het naar de volgende stap gaat.

python

1response = requests.post(tasks_url, headers=headers, json=payload)
2response.raise_for_status()
3task = response.json()
4task_id = task["@id"]

Vervolgens controleert de statusrequest de taak totdat de status completed, failed of stopped wordt. De pauze van drie seconden voorkomt dat het script continu statusrequests verstuurt.

Tot slot leest de resultatenrequest pagina’s met maximaal 100 resultaten uit. Als nextCursor een waarde bevat, stuurt de loop die bij de volgende request mee als cursor. De loop stopt pas wanneer nextCursor null is.

Matches beoordelen en bepalen wat controle nodig heeft

Hieronder staat de volledige resultatenlijst voor de vijf inputs:

json

[
  {
    "inputId": "account-datablist",
    "status": "success",
    "outputs": {
      "companyWebsite": "datablist.com",
      "confidence": "high",
      "companyLinkedInUrl": "https://www.linkedin.com/company/datablist",
      "companyName": "datablist"
    },
    "creditsUsed": "1.5",
    "error": null
  },
  {
    "inputId": "account-posthog",
    "status": "success",
    "outputs": {
      "companyWebsite": "posthog.com",
      "confidence": "high",
      "companyLinkedInUrl": "https://www.linkedin.com/company/posthog",
      "companyName": "PostHog"
    },
    "creditsUsed": "1.5",
    "error": null
  },
  {
    "inputId": "account-n8n",
    "status": "success",
    "outputs": {
      "companyWebsite": "n8n.io",
      "confidence": "high",
      "companyLinkedInUrl": "https://www.linkedin.com/company/n8n",
      "companyName": "n8n"
    },
    "creditsUsed": "1.5",
    "error": null
  },
  {
    "inputId": "account-vaude",
    "status": "success",
    "outputs": {
      "companyWebsite": "vaude.com",
      "confidence": "high",
      "companyLinkedInUrl": "https://www.linkedin.com/company/vaude",
      "companyName": "vaude"
    },
    "creditsUsed": "1.5",
    "error": null
  },
  {
    "inputId": "account-drooms",
    "status": "success",
    "outputs": {
      "companyWebsite": "drooms.com",
      "confidence": "low",
      "companyLinkedInUrl": "https://www.linkedin.com/company/drooms-software",
      "companyName": "Drooms"
    },
    "creditsUsed": "1.5",
    "error": null
  }
]

Lees status en confidence afzonderlijk. De API retourneert voor elke input een resultaatobject, ook als de input geen succesvol resultaat oplevert. De status success betekent dat er een mogelijke bedrijfspagina is gevonden. De waarde van outputs.confidence geeft aan of de match met de website is gevalideerd. inputId koppelt het object aan je bronaccount, creditsUsed registreert de kosten voor die rij en error bevat bij een fout gestructureerde informatie over de oorzaak.

Bewaar het volledige outputs-object in je applicatie, zelfs als je in het eerste scherm alleen de LinkedIn-URL en confidence nodig hebt. companyName en companyWebsite versnellen de handmatige controle, vooral als de geretourneerde bedrijfsnaam anders is geschreven of de input een volledige URL was. Bovendien geven ze nuttige context zonder dat je opnieuw een API-call hoeft te doen.

Het matchingproces normaliseert eerst de ingestuurde website en controleert bedrijfsdatasets op een bekende relatie tussen de website en LinkedIn. Daarna vergelijkt het systeem het inputdomein met de website die op de mogelijke LinkedIn-bedrijfspagina staat. Een match op het geregistreerde domein levert een high confidence op.

Als de datasets geen LinkedIn-URL bevatten, kan de lookup een gerichte Google-zoekopdracht uitvoeren naar mogelijke bedrijfspagina’s. Een kandidaat die niet kan worden gevalideerd aan de hand van een gepubliceerde website, kan met een low confidence worden teruggestuurd. Een bekende mismatch tussen websites wordt niet geaccepteerd.

Beschouw confidence als een instructie voor controle. VAUDE retourneerde https://www.linkedin.com/company/vaude met een high confidence en kan dus direct naar de onderzoekswachtrij. Drooms retourneerde https://www.linkedin.com/company/drooms-software met een low confidence. Open de website en LinkedIn-pagina van Drooms voordat je op deze relatie vertrouwt.

Ook Datablist, PostHog en n8n leverden matches met een hoge confidence op. Deze API vindt de relatie tussen een website en een bedrijfspagina. Heb je na controle van de URL ook de bedrijfsgrootte, branche of andere paginagegevens nodig? Gebruik dan als volgende stap de handleiding voor de LinkedIn company scraper API.

Wachtrij voor account research maken

Gebruik match_results nu opnieuw om een lokale wachtrij voor handmatig bedrijfsonderzoek te maken. Dit codeblok doet geen nieuwe API-call. Het indexeert de resultaten op inputId en loopt daarna door de oorspronkelijke accountlijst, zodat elk bronaccount zichtbaar blijft, zelfs als een toekomstig resultaat ontbreekt.

python

1results_by_id = {result["inputId"]: result for result in match_results}
2ready_for_research = []
3needs_review = []
4
5for account in accounts:
6    result = results_by_id.get(account["account_id"])
7    if result is not None:
8        outputs = result.get("outputs", {})
9    else:
10        outputs = {}
11
12    research_record = {
13        **account,
14        "companyLinkedInUrl": outputs.get("companyLinkedInUrl"),
15        "confidence": outputs.get("confidence"),
16        "api_result": result,
17    }
18
19    is_ready = (
20        result is not None
21        and result["status"] == "success"
22        and outputs.get("companyLinkedInUrl")
23        and outputs.get("confidence") == "high"
24    )
25    if is_ready:
26        ready_for_research.append(research_record)
27    else:
28        needs_review.append(research_record)
29
30print("Ready for research:")
31print(json.dumps(ready_for_research, indent=2))
32print("Needs review:")
33print(json.dumps(needs_review, indent=2))

Dankzij de resultatendictionary is de koppeling niet afhankelijk van de volgorde waarin de response binnenkomt. account-vaude koppelt het oorspronkelijke record voor vaude.com aan de gevonden VAUDE-pagina en komt in ready_for_research terecht. account-drooms behoudt de volledige input-URL en het volledige API-resultaat, maar gaat naar needs_review, omdat de confidence laag is, ook al is de resultaatstatus success.

Met dezelfde logica blijft ook een ontbrekende rij of een rij met no_result of een fout in de controlewachtrij staan. De twee geprinte lijsten geven het team een duidelijk vertrekpunt voor handmatig bedrijfsonderzoek.

VAUDE komt na een LinkedIn-bedrijfspaginamatch met hoge confidence in Ready for research en Drooms na een match met lage confidence in Needs review

Je kunt ook het onderhouden synchrone Requests-voorbeeld downloaden. De repository bevat daarnaast een asynchroon HTTPX-voorbeeld voor applicaties die non-blocking HTTP nodig hebben. Voor een eerste integratie is de blocking versie hierboven echter makkelijker te volgen.

Van LinkedIn-bedrijfspagina naar website zoeken

Dezelfde functie accepteert LinkedIn-bedrijfspagina’s wanneer je de matchingrichting wijzigt. Dat is handig als je bronlijst URL’s van bedrijfspagina’s bevat en je eerst websites nodig hebt voor een compatibele bedrijfs- of werkmail-enrichment.

python

1linkedin_accounts = [
2    {
3        "account_id": "account-datablist",
4        "company_name": "Datablist",
5        "source_url": "https://www.linkedin.com/company/datablist",
6    }
7]
8
9website_results = match_companies(
10    linkedin_accounts,
11    api_key,
12    matching_direction="linkedin_to_domain",
13)

Voor een standaardlookup van een LinkedIn-bedrijfspagina geldt het normale matchingtarief. Numerieke bedrijfs-ID’s en bedrijfs-URL’s uit Sales Navigator kunnen 10 credits kosten, omdat ze een ander reverse-lookuptraject volgen. Bekijk voor een no-code versie van deze richting hoe je website-URL’s uit LinkedIn-bedrijfspagina’s haalt.

Credits voor website-naar-LinkedIn-lookups berekenen

Een geslaagde reguliere website-naar-LinkedIn-lookup kost 1,5 credits. De vijf getoonde matches hebben dus 7,5 credits verbruikt. Tegen hetzelfde tarief kosten 1.000 geslaagde matches 1.500 credits. Ongeldige inputs en rijen zonder resultaat kunnen nul credits kosten. Controleer daarom bij elk resultaat de waarde van creditsUsed voor het werkelijke verbruik.

Toegang tot de REST API maakt deel uit van het Growth-abonnement. Het maandabonnement staat los van aanvullende credits. Met een top-up van $ 20 krijg je 20.000 credits, waardoor één credit $ 0,001 kost. Bij 1,5 credits per geslaagde match kosten 1.000 matches 1.500 credits, oftewel $ 1,50. Bekijk de prijzen van Datablist voor de actuele abonnementen en pakketten.

Loading pricing…

Veelvoorkomende problemen met input, taken en resultaten oplossen

DATABLIST_API_KEY ontbreekt: het script stopt voordat het een request verstuurt. Exporteer de environment variable en voer het commando opnieuw uit.
De API weigert de key: controleer of je een Personal API Key hebt gekopieerd en of de request deze uitsluitend in X-API-Key verstuurt.
De input wordt niet ondersteund: gebruik voor domain_to_linkedin een bedrijfswebsite of domein. Gebruik voor de omgekeerde richting een ondersteunde URL van een bedrijfspagina, geen persoonlijk profiel of lege waarde.
Je hebt onvoldoende credits: controleer je saldo en gebruik daarna de inbegrepen credits of voeg een top-up toe voordat je een nieuwe taak aanmaakt.
De taak heeft de status failed of stopped: bekijk de taakstatus, foutmelding, bestaande resultaten en het creditverbruik voordat je besluit de taak opnieuw in te sturen.
Een resultaat heeft een lage confidence, no_result of een fout: bewaar de bronwebsite en het volledige resultaat in needs_review. Open de mogelijke pagina als die bestaat en ga niet speculeren over de oorzaak van een ontbrekend resultaat.

Als de verbinding tijdens het aanmaken van de taak wegvalt, gebruik je de uniqueId die vóór de POST is geprint. Vraag je takenlijst op en zoek naar die waarde voordat je een nieuwe taak aanmaakt:

shell

1curl --get "https://api.datablist.com/v1/enrichments/tasks" \
2  --header "X-API-Key: $DATABLIST_API_KEY" \
3  --data-urlencode "enrichmentId=company-to-linkedin" \
4  --data-urlencode "limit=100"

Je kunt de takenlijst niet filteren op uniqueId. Controleer daarom elke geretourneerde taak en volg indien nodig nextCursor. Zodra je de bijbehorende waarde hebt gevonden, gebruik je de @id met dezelfde status- en resultaat-URL’s als in het script.

Eén taak kan maximaal 10.000 inputs bevatten. Raadpleeg de Company to LinkedIn API-documentatie voor alle limieten voor requests, taakretentie en paginering.

Volgende stappen

Je hebt nu één herbruikbare Python Requests-functie die bedrijfswebsites omzet in mogelijke LinkedIn-bedrijfspagina’s. In de lokale wachtrij blijven matches met een hoge confidence klaarstaan voor onderzoek, terwijl onzekere of mislukte records zichtbaar blijven voor controle.

Vervang de vijf voorbeelden door een kleine accountlijst en controleer elke kandidaat met een lage confidence. Gebruik de goedgekeurde URL’s daarna voor handmatig bedrijfsonderzoek of als input voor de LinkedIn company scraper API. Bevat je bronlijst bedrijfsnamen in plaats van websites? Begin dan met de handleiding voor de company website finder API.