REST API

Programmatic access to a nightly-synced mirror of the UN Digital Library.
Anonymous access available at 10 req/min — sign in for a free key with higher limits.

API Reference (Swagger)

Authentication

Anonymous

Make requests without credentials. Lower rate limits apply.

curl "https://digitallibrary.unfck.org/v1/search?q=A/RES"

API Key

Pass your key via Authorization header or ?api_key= param.

curl -H "Authorization: Bearer undl_live_..." \
  "https://digitallibrary.unfck.org/v1/search?q=A/RES"

Rate Limits

Tier	Rate	Daily	Access
Anonymous	10 req/min	100	No key needed
Free	60 req/min	10,000	Free API key
Research	300 req/min	100,000	Approved researchers
Institutional	1,000 req/min	Unlimited	UN agencies & partners

Quick Start

curl

# Search
curl "https://digitallibrary.unfck.org\
  /v1/search?q=climate"

# With API key
curl \
  -H "Authorization: Bearer KEY" \
  "https://digitallibrary.unfck.org\
  /v1/search?q=climate"

Python

import httpx

BASE = "https://digitallibrary.unfck.org"

r = httpx.get(
  f"{BASE}/v1/search",
  params={"q": "climate"},
  headers={
    "Authorization": "Bearer KEY"
  },
)
docs = r.json()["results"]

JavaScript

const BASE =
  "https://digitallibrary.unfck.org";

const res = await fetch(
  `${BASE}/v1/search?q=climate`,
  {
    headers: {
      Authorization: `Bearer ${KEY}`,
    },
  }
);
const { results } = await res.json();

Full endpoint reference

Browse all endpoints, parameters, and response schemas in the interactive Swagger UI.

Open API Reference

Get your API key

Free keys are available. Sign in to generate your key and start building.