Public API to DuckDB Integration
AI-first ETL from Public API into DuckDB. Governed entities, incremental sync, typed landing tables.
How Datrise loads Public API into DuckDB
Datrise syncs Public API's records, response payloads, pagination cursors, request parameters, schemas, and fetch timestamps 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
Public API: Generic REST endpoint pulled on a schedule.
DuckDB: In-process analytics database for fast local OLAP.
How Public API entities map to DuckDB
| Public API entity | DuckDB object | Notes |
|---|---|---|
| records | public_api_records | id PK · custom fields → JSON or STRUCT columns |
| response payloads | public_api_response_payloads | id PK · linked to public_api_records |
| pagination cursors | public_api_pagination_cursors | id PK · linked to public_api_records |
| request parameters | public_api_request_parameters | id PK · linked to public_api_records |
FAQ
How does Datrise handle Public 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 Public 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
More destinations for Public API
Early access
Connect Public 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.