{"openapi": "3.0.0", "info": {"title": "DeityDB API", "version": "1.0", "description": "Read-only JSON API over the DeityDB comparative-religion graph."}, "servers": [{"url": "http://deitydb-explorer.fly.dev"}], "paths": {"/api/entity/{id}": {"get": {"summary": "An entity with its relationships, sources and periods", "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "string"}, "description": "entity_id"}], "responses": {"200": {"description": "OK"}}}}, "/api/neighbors/{id}": {"get": {"summary": "Adjacent entities", "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "string"}, "description": "entity_id"}, {"name": "type", "in": "query", "required": false, "schema": {"type": "string"}, "description": "relationship_type filter"}, {"name": "tradition", "in": "query", "required": false, "schema": {"type": "string"}, "description": "tradition filter"}, {"name": "direction", "in": "query", "required": false, "schema": {"type": "string"}, "description": "out|in|both"}], "responses": {"200": {"description": "OK"}}}}, "/api/path": {"get": {"summary": "Shortest relationship path between two entities", "parameters": [{"name": "from", "in": "query", "required": true, "schema": {"type": "string"}, "description": "start entity_id"}, {"name": "to", "in": "query", "required": true, "schema": {"type": "string"}, "description": "end entity_id"}, {"name": "maxdepth", "in": "query", "required": false, "schema": {"type": "string"}, "description": "max steps (<=8)"}], "responses": {"200": {"description": "OK"}}}}, "/api/search": {"get": {"summary": "Search entities by name", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string"}, "description": "query (>=2 chars)"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "string"}, "description": "max results"}], "responses": {"200": {"description": "OK"}}}}, "/api/tradition/{name}": {"get": {"summary": "Entities of a tradition + its profile", "parameters": [{"name": "name", "in": "path", "required": true, "schema": {"type": "string"}, "description": "tradition name"}], "responses": {"200": {"description": "OK"}}}}, "/api/graph.json": {"get": {"summary": "Nodes+links for graph rendering", "parameters": [{"name": "tradition", "in": "query", "required": false, "schema": {"type": "string"}, "description": "restrict to a tradition"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "string"}, "description": "max nodes"}], "responses": {"200": {"description": "OK"}}}}, "/api/meta": {"get": {"summary": "Counts + relationship-type and tradition vocabularies", "parameters": [], "responses": {"200": {"description": "OK"}}}}}}