Headlessly
REST API

Assets API

Direct Parquet file access with CDN caching and ETag support.

Endpoint

GET /assets/:filename

Access raw Parquet data files directly. Responses are CDN-cached with ETag support for efficient bandwidth usage.

Examples

# Download Contact data
curl "https://db.headless.ly/assets/Contact.parquet" -o contacts.parquet

# Conditional request (only download if changed)
curl "https://db.headless.ly/assets/Deal.parquet" \
  -H "If-None-Match: \"abc123\"" \
  -o deals.parquet -w "%{http_code}"

Response Headers

HeaderDescription
ETagFile hash for conditional requests
Content-Typeapplication/octet-stream
Content-LengthFile size in bytes
Cache-ControlCDN cache directives
Last-ModifiedLast modification timestamp

Status Codes

StatusMeaning
200File returned
304Not modified (ETag matched)
404File not found

Import & Export

Bulk import and export data in JSON, NDJSON, CSV, and Parquet formats.

Integrations

Stripe, GitHub, analytics forwarding, and dashboards.

On this page

EndpointExamplesResponse HeadersStatus Codes