Lead Generation

Doctors & Health Professionals (Belgium)

Every licensed care provider in Belgium — doctors, dentists, pharmacists, nurses, physiotherapists and 20 more professions — with practitioner number, qualification, convention status and geocoded work addresses.

doctors-belgiumlead-generationhealthcaredoctorsbelgiumpublic-record

330,455 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/doctors-belgium/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 330,455 rows, this download costs 3,305 credits when the data is fresh enough, or 6,610 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/doctors-belgium/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "professions": [        "10"      ],      "maxRecords": 1000000,      "pageSize": 2000,      "requestDelayMs": 1000    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

professions
enum[]
Professions
Empty pulls all 25 professions in the INAMI register (~330k people). Doctors alone are ~65k.
Default
none
Allowed values
10
30
20
68
41
42
40
50
78
98
58
56
65
57
59
31
66
67
62
61
63
21
22
23
24

Advanced

maxRecords
number
Max records per run
Default
1000000
Range
1 to 1000000
pageSize
number
Page size
Cards per request. 2,000 is a ~7 MB page; the site accepts up to 5,000.
Default
2000
Range
1 to 5000
requestDelayMs
number
Delay between requests (ms)
Default
1000
Range
0 to 60000

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "professions": {      "type": "array",      "items": {        "type": "string",        "enum": [          "10",          "30",          "20",          "68",          "41",          "42",          "40",          "50",          "78",          "98",          "58",          "56",          "65",          "57",          "59",          "31",          "66",          "67",          "62",          "61",          "63",          "21",          "22",          "23",          "24"        ]      },      "uniqueItems": true,      "title": "Professions",      "description": "Empty pulls all 25 professions in the INAMI register (~330k people). Doctors alone are ~65k.",      "default": []    },    "maxRecords": {      "type": "number",      "minimum": 1,      "maximum": 1000000,      "title": "Max records per run",      "default": 1000000    },    "pageSize": {      "type": "number",      "minimum": 1,      "maximum": 5000,      "title": "Page size",      "description": "Cards per request. 2,000 is a ~7 MB page; the site accepts up to 5,000.",      "default": 2000    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between requests (ms)",      "default": 1000    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/doctors-belgium/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "professions": [        "10"      ],      "maxRecords": 1000000,      "pageSize": 2000,      "requestDelayMs": 1000    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

Field	Type	Coverage
address_line	string	51%
addresses	array	100%
city	string	51%
convention_label	string	94%
convention_status	string	94%
first_name	string	99%
full_name	string	100%
last_name	string	100%
latitude	number	51%
longitude	number	51%
organization_name	string	42%
postal_code	string	51%
practitioner_full_number	string	99%
practitioner_key	string	100%
practitioner_number	string	100%
profession	string	100%
profession_code	string	100%
province	string	51%
qualification_code	string	99%
qualification_date	date	100%
qualification_label	string	100%
region	string	51%
created_at	date	100%
first_seen_at	date	100%
last_seen_at	date	100%
updated_at	date	100%
_id	string	100%