Belastingdienst APIbelastingdienst.nl ↗
Search and retrieve official Dutch tax information, forms, and guidance directly from the Netherlands Tax Authority to find answers about tax obligations, deductions, and compliance requirements. Access specific pages and documents from the Belastingdienst database to get accurate, up-to-date tax details relevant to your situation.
curl -X POST 'https://api.parse.bot/scraper/7bf4673a-67d5-43de-b9da-266551d6c913/search' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"count": "10",
"query": "btw aangifte"
}'Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace belastingdienst-nl-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: belastingdienst_nl_api SDK — bounded, re-runnable; every call capped."""
from parse_apis.belastingdienst_nl_api import Belastingdienst, PageNotFound
client = Belastingdienst()
# Search for tax info on VAT returns
for result in client.pages.search(query="btw aangifte", limit=3):
print(result.title, result.url)
# Drill down: get the first result's full page content
hit = client.pages.search(query="inkomstenbelasting", limit=1).first()
try:
page = hit.details()
print(page.title, page.meta_description)
for section in page.sections[:5]:
print(section.tag, section.text[:80])
except PageNotFound as e:
print("page gone:", e.path)
print("exercised: pages.search, SearchResult.details")
Full-text search over all Dutch tax information pages. Returns ranked results with title, description, and URL. Each item is a summary with enough context to decide which page to fetch in full.
| Param | Type | Description |
|---|---|---|
| count | integer | Number of results to return (1-100). |
| queryrequired | string | Search terms in Dutch (e.g. 'btw aangifte', 'inkomstenbelasting'). |
{
"type": "object",
"fields": {
"query": "The search query that was executed",
"results": "Array of search result items with title, description, and url",
"estimated_count": "Total estimated matching results across the index"
},
"sample": {
"data": {
"query": "btw aangifte",
"results": [
{
"url": "https://www.belastingdienst.nl/wps/wcm/connect/nl/jonge-ondernemers/jonge-ondernemers",
"title": "Jonge ondernemers en de btw-aangifte",
"description": "We willen jonge ondernemers graag helpen met de btw-aangifte. Een foutje is namelijk snel gemaakt."
},
{
"url": "https://www.belastingdienst.nl/wps/wcm/connect/nl/btw/content/ik-moet-btw-aangifte-doen-hoe-vul-ik-die-in",
"title": "Ik moet btw-aangifte doen - hoe vul ik die in?",
"description": "Hebt u hulp nodig met het invullen van de btw-aangifte? Op deze pagina leggen we u stap voor stap uit hoe u de btw-aangifte invult."
}
],
"estimated_count": 449
},
"status": "success"
}
}About the Belastingdienst API
The Belastingdienst API on Parse exposes 2 endpoints for the publicly available data on belastingdienst.nl. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.