Citation API

Authentication

All API requests require a valid API key. Include it in the Authorization header using Bearer authentication.

Authorization: Bearer YOUR_API_KEY

Generate your key from the Developer Dashboard. Keys are scoped to specific environments and automatically expire after 90 days.

Rate Limits

API usage is governed by tiered rate limits to ensure platform stability. Exceeding limits returns a 429 Too Many Requests status.

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

GET /cite

Retrieves verified citation metadata for a given DOI, ISBN, URL, or article slug. Returns structured data including authors, publication date, journal, and verification status.

curl -X GET "https://api.aevumencyclopedia.dev/v1/cite?identifier=10.1038/s41586-023-06700-3" \\
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
  "https://api.aevumencyclopedia.dev/v1/cite",
  params={"identifier": "10.1038/s41586-023-06700-3"},
  headers={"Authorization": "Bearer YOUR_API_KEY"}
)
print(resp.json())

const resp = await fetch("https://api.aevumencyclopedia.dev/v1/cite?identifier=10.1038/s41586-023-06700-3", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await resp.json();

{
  "id": "cite_8f3a2b1c",
  "identifier": "10.1038/s41586-023-06700-3",
  "title": "Quantum advantage in machine learning",
  "authors": ["Chen, L.", "Wang, M.", "Santos, R."],
  "publication": "Nature",
  "year": 2023,
  "verified": true,
  "verification_date": "2024-01-15T08:30:00Z",
  "formats": {
    "apa": "Chen, L., Wang, M., & Santos, R. (2023). Quantum advantage...",
    "mla": "Chen, Li et al. \"Quantum advantage...\" Nature, 2023."
  }
}

POST /verify

Submits a citation or reference for AI-assisted verification. Cross-references against trusted academic databases, publisher registries, and DOI handles.

// POST /verify
{
  "citation": {
    "authors": ["Einstein, A.", "Podolsky, B.", "Rosen, N."],
    "title": "Can Quantum-Mechanical Description of Physical Reality Be Considered Complete?",
    "journal": "Physical Review",
    "year": 1935
  },
  "strict": true
}

GET /format

Converts a citation identifier into multiple academic styles: APA 7th, MLA 9th, Chicago, Harvard, and BibTeX.

Status Codes & Errors

The API uses standard HTTP status codes and returns structured JSON error objects.

{
  "error": {
    "code": "CITATION_NOT_FOUND",
    "message": "No verified record matches the provided identifier.",
    "suggestion": "Check DOI syntax or use POST /verify for new entries."
  }
}