API & feeds

Free catalog and blog feeds, plus a public REST API for the Bassel Khartabil knowledge base. Feeds are free — no key required. Request a key only when you want to contribute archives or use authenticated endpoints.

API base: /api/v1

Request an API key

Contributors can submit archives for review. Tell us your email and we will follow up (verification email required).

You can also request a key from Contribute.

Free feeds

JSON and Atom catalogs at /data/, plus site news syndication. No authentication.

Catalog feeds

Feed	JSON	Atom
People	/data/people.json	/data/people.atom
Artworks	/data/artworks.json	/data/artworks.atom
Projects	/data/projects.json	/data/projects.atom
History	/data/events.json	/data/events.atom
Archives	/data/archives.json	/data/archives.atom
Gaps	/data/gaps.json	/data/gaps.atom
News	/data/news.json	/data/news.atom
What's new	/data/changelog.json	/data/changelog.atom

Site blog feeds

Format	URL
Atom	/atom.xml
RSS	/rss.xml

Public API

Same catalogs and a few write endpoints that do not require a key.

Method	Path	Description
GET	`/api/v1/health/`	Service health
GET	`/api/v1/stats/`	Collection metrics
GET	`/api/v1/people/`	People (JSON)
GET	`/api/v1/artworks/`	Artworks (JSON)
GET	`/api/v1/projects/`	Projects (JSON)
GET	`/api/v1/events/`	History (JSON)
GET	`/api/v1/archives/`	Archives catalog (JSON)
GET	`/api/v1/gaps/`	Knowledge gaps (JSON)
GET	`/api/v1/news/`	News index (JSON)
GET	`/api/v1/interests/`	Interest tags for signup
POST	`/api/v1/subscribe/`	Email list signup
POST	`/api/v1/key-request/`	Request an API key
POST	`/api/v1/fellowship-applications/`	Fellowship application

With an API key

Send your key as the X-Api-Key header. Contributor keys can submit archives; admins review them in the private dashboard.

Method	Path	Role	Description
GET	`/api/v1/auth/me/`	any key	Confirm your role
POST	`/api/v1/submissions/`	contributor	Submit an archive (JSON)
POST	`/api/v1/submissions/upload/`	contributor	Submit with files (multipart)

Request an API key Contribute archives