DatriseAI-first ETL

The Guardian API to DuckDB Integration

AI-first ETL from The Guardian API into DuckDB. Governed entities, incremental sync, typed landing tables.

How Datrise loads The Guardian API into DuckDB

Datrise syncs The Guardian API's articles, sections, tags, contributors, publication dates, and headlines into DuckDB as a typed table per source entity in a DuckDB file. Flexible or custom fields land in JSON or STRUCT columns, and timestamps such as created, updated, and status changes are typed as TIMESTAMP WITH TIME ZONE.

Sync is incremental: Datrise uses rewrites changed entities into the local database (or Parquet) on each run, so re-runs update only what changed. Hive-partitioned Parquet by load date when exporting. DuckDB is single-writer and embedded, so Datrise produces a consistent file snapshot rather than concurrent streaming writes.

Ideal for local and notebook analytics without standing up a server.

Endpoints

The Guardian API: Guardian article archive and section metadata.

DuckDB: In-process analytics database for fast local OLAP.

How The Guardian API entities map to DuckDB

The Guardian API entityDuckDB objectNotes
articlesthe_guardian_api_articlesid PK · custom fields → JSON or STRUCT columns
sectionsthe_guardian_api_sectionsid PK · linked to the_guardian_api_articles
tagsthe_guardian_api_tagsid PK · linked to the_guardian_api_articles
contributorsthe_guardian_api_contributorsid PK · linked to the_guardian_api_articles

FAQ

How does Datrise handle The Guardian API's custom fields in DuckDB?

Flexible values are stored as JSON or STRUCT columns, so new fields don't require a migration; strongly-typed fields — dates, numbers, and references — are promoted to native DuckDB types.

How does the The Guardian API to DuckDB sync stay up to date?

It runs incrementally — Datrise uses rewrites changed entities into the local database (or Parquet) on each run.

Related pipelines

Early access

Connect The Guardian API to DuckDB the easy way

Skip brittle scripts and manual exports. Join the waitlist to get a guided setup, AI-assisted mapping, and reliable incremental sync for this integration.