Overview

nu-private-api wraps the public NU.nl web GraphQL endpoint used by the site itself. It is intentionally small: give it a section or article URL, get back article URLs or a parsed article object.

Use it for scripts, experiments, and lightweight content extraction where a full browser is unnecessary.

[!WARNING] This is an unofficial client for NU.nl web endpoints. It may break when NU.nl changes its private response shape.

Features

• Fetch de-duplicated article URLs from public NU.nl section/list pages.
• Fetch and parse public article pages.
• Return normalized article fields: URL, title, description, publish time, modified time, author, and body text.
• Fetch section URLs from NU.nl's section sitemap.
• Bring your own configured httpx.Client when you need custom timeouts, proxies, headers, or lifecycle control.

Install

python -m pip install nu-private-api

Quick Start

from nu_private_api import NuClient

client = NuClient()

section_urls = client.sitemap_urls()
urls = client.section_by_url(section_urls[0])
article = client.article_by_url(urls[0])

print(article.title)
print(article.author)
print(article.body)

Raw URLs work too:

urls = client.section_by_url("https://www.nu.nl/binnenland")
article = client.article_by_url("https://www.nu.nl/123456/example.html")

Use your own httpx.Client if you want to control connection settings:

import httpx

from nu_private_api import NuClient

with httpx.Client(timeout=10) as http:
    client = NuClient(client=http)
    article = client.article_by_url("https://www.nu.nl/123456/example.html")

API

NuClient.sitemap_urls(url="https://www.nu.nl/sitemap_sections.xml")

Fetches a sitemap and returns the URLs from its <loc> entries.

from nu_private_api import NuClient

client = NuClient()
section_urls = client.sitemap_urls()

NuClient.section_by_url(url)

Fetches a NU.nl section/list page and returns de-duplicated absolute article URLs.

from nu_private_api import NuClient

client = NuClient()
section_urls = client.sitemap_urls()
urls = client.section_by_url(section_urls[0])

url is a NU.nl section/list URL string.

NuClient.article_by_url(url)

Fetches and parses a public article URL.

article = client.article_by_url(urls[0])

Returns an immutable Article dataclass:

Article(
    url="...",
    title="...",
    description="...",
    published_at="...",
    modified_at="...",
    author="...",
    body="...",
)

Notes

• Public article reads do not require cookies or login.
• Video pages and live blogs are not supported.
• The current parser follows the observed NU.nl article shape: base64 JSON-LD schema, screenMetadata, and article text blocks.
• API research notes live in docs/apis.