Developer API

Gnosis Lexicon API

Free, open access to a growing corpus of gnostic and esoteric terminology. Built for researchers, developers, and anyone building tools for the study of ancient wisdom traditions.

Base URL

GET https://pleroma.stefansalkimia.com/api/lexicon/public

Authentication

None required. The API is free and open. No API key needed.

Rate Limits

100 requests per hour per IP address. Rate limit headers are included in every response.

X-RateLimit-Limit: 100

X-RateLimit-Remaining: 99

X-RateLimit-Reset: 1712764800

Endpoints

GET /api/lexicon/public

Returns a paginated list of all lexicon terms. Supports filtering by pillar, locale, and search query.

Query Parameters

Parameter	Type	Default	Description
locale	string	"en"	Language: "en" (English) or "bg" (Bulgarian)
pillar	string	-	Filter by knowledge pillar (e.g. cosmology, alchemy, shadow)
q	string	-	Search term name (case-insensitive partial match)
limit	number	50	Results per page (1-500)
offset	number	0	Pagination offset

Example Request

curl

curl "https://pleroma.stefansalkimia.com/api/lexicon/public?pillar=cosmology&limit=10"

Example Response

JSON

{
  "data": [
    {
      "term": "Archon",
      "slug": "archon",
      "definition": "A cosmic parasitic entity in Gnostic cosmology...",
      "pillar": "cosmology",
      "tradition": "Gnostic",
      "etymology": "Greek: archon — ruler",
      "relatedTerms": [
        "demiurge",
        "sophia"
      ],
      "url": "https://pleroma.stefansalkimia.com/en/lexicon/archon"
    }
  ],
  "meta": {
    "total": 143,
    "limit": 50,
    "offset": 0,
    "locale": "en"
  },
  "attribution": {
    "source": "Pleroma Gnosis Lexicon",
    "url": "https://pleroma.stefansalkimia.com",
    "license": "CC BY-SA 4.0",
    "required": "Attribution required: 'Powered by Pleroma Gnosis'"
  }
}

GET /api/lexicon/public/[slug]

Returns a single term by its slug, including full content and related blog posts that reference it.

Example Request

curl

curl "https://pleroma.stefansalkimia.com/api/lexicon/public/archon"

Example Response

JSON

{
  "data": {
    "term": "Archon",
    "slug": "archon",
    "definition": "A cosmic parasitic entity in Gnostic cosmology...",
    "fullContent": "A cosmic parasitic entity in Gnostic cosmology that rules the material world...",
    "pillar": "cosmology",
    "tradition": "Gnostic",
    "etymology": "Greek: archon — ruler",
    "pronunciation": "AR-kon",
    "termOriginal": null,
    "relatedTerms": [
      "demiurge",
      "sophia"
    ],
    "relatedPosts": [
      {
        "title": "What Are Archons?",
        "slug": "what-are-archons",
        "url": "https://pleroma.stefansalkimia.com/en/blog/what-are-archons"
      }
    ],
    "url": "https://pleroma.stefansalkimia.com/en/lexicon/archon"
  },
  "attribution": {
    "source": "Pleroma Gnosis Lexicon",
    "url": "https://pleroma.stefansalkimia.com",
    "license": "CC BY-SA 4.0",
    "required": "Attribution required: 'Powered by Pleroma Gnosis'"
  }
}

Available Pillars

Use these values with the pillar query parameter to filter terms by knowledge domain.

cosmology

alchemy

frequency

temple

matrix

shadow

astrology

mastery

sophia

Attribution

This API is licensed under CC BY-SA 4.0. You are free to use the data in any project, provided you include attribution linking back to Pleroma.

HTML

Powered by Pleroma Gnosis

License

Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0). You may share and adapt the data for any purpose, including commercial, as long as you provide attribution and distribute derivative works under the same license.

Error Codes

Code	Meaning
200	Success
400	Bad request (invalid locale or parameters)
404	Term not found (single-term endpoint only)
429	Rate limit exceeded. Check the Retry-After header.