Sacred Atlas API and dataset

Reading Sacred Atlas is free, and always will be. This page is for machines: companies that want our data in bulk, for example to train AI models.

Why there is a price

The scriptures are public domain. What we built around them is our own work. We compared the traditions passage by passage, linked verses across books, and wrote the parallels, themes, figures, places, glossary and timeline. People, search engines and AI answer engines that cite and link to us read all of it free. Crawlers that collect pages to train AI models get HTTP 402 Payment Required. They can buy the same material here, cleaner and in bulk, for a few tenths of a cent per request.

What is included

Not included: copyrighted translations. Every Qur'an translation is left out. Where the compilation quotes the Qur'an, the quote is replaced by its reference. Translations whose licence we could not confirm are also left out.

Prices

EndpointPrice (USDC)
GET /v1/sacredatlas: catalogue, counts, licencesfree
GET /v1/sacredatlas/data/{dataset}: a whole compilation dataset (parallels, themes, figures, places, glossary, timeline)0.01
GET /v1/sacredatlas/record/{dataset}/{id}: one record0.002
GET /v1/sacredatlas/text/{work}/{book}: one book of a public-domain text0.005
GET /v1/sacredatlas/crossrefs/{book}: cross-references for one book0.005
GET /v1/sacredatlas/commentary/{source}/{book}-{chapter}: one chapter of commentary0.002

Base URL: https://api.codexery.com. You can buy the whole compilation for about 0.06 USDC, and every public-domain text for a few dollars.

How to pay

Payment uses the open x402 protocol, settled in USDC on Base mainnet. You need no account and no API key.

  1. Request a priced endpoint. The reply is 402 with a PAYMENT-REQUIRED header: base64 JSON giving the amount, asset and recipient.
  2. Sign the USDC transfer with any x402 client, then repeat the request with the PAYMENT-SIGNATURE header.
  3. The data comes back with a PAYMENT-RESPONSE receipt.
curl -i https://api.codexery.com/v1/sacredatlas            # free catalogue
curl -i https://api.codexery.com/v1/sacredatlas/data/themes # 402 + payment terms

Attribution

If you publish or display this data, credit Sacred Atlas (sacredatlas.org) and link back to us. The attribution policy for AI answer engines is in llms.txt.