Jolanism Public API

Authentication

All API requests require an API key. Include it via the X-API-Key header or as an api_key query parameter.

curl -H "X-API-Key: jol_your_key_here" \
  "https://jolanism.com/v1/search?q=سوريا"

GET /v1/search

Search transcripts and executive orders. Requires search scope.

Parameters

Example

curl -H "X-API-Key: jol_xxx" \
  "https://jolanism.com/v1/search?q=سوريا&type=transcripts&size=5"

Response

{
  "query": "سوريا",
  "type": "transcripts",
  "total": 42,
  "results": [
    {
      "id": "12345",
      "title": "خطاب حول مستقبل سوريا",
      "type": "speech",
      "estimated_date": "2024-12-15",
      "duration_seconds": 1200,
      "score": 15.7,
      "highlights": ["...مستقبل <mark>سوريا</mark>..."]
    }
  ]
}

POST /v1/ask

Ask a question — the API searches the archive and uses AI to synthesize an answer. Requires ask or full scope.

Request Body

{ "question": "ما موقف الرئيس من التعليم؟" }

Example

curl -X POST \
  -H "X-API-Key: jol_xxx" \
  -H "Content-Type: application/json" \
  -d '{"question": "ما موقف الرئيس من التعليم؟"}' \
  "https://jolanism.com/v1/ask"

Response

{
  "answer": "بحسب المصادر المتاحة...",
  "sources": [
    { "id": "12345", "title": "لقاء حول التعليم" },
    { "id": "67890", "title": "خطاب افتتاح المدارس" }
  ]
}

Rate Limits

Each API key has a per-minute rate limit (default: 60 requests/min). Rate limit info is included in response headers:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 45

When exceeded, the API returns 429 Too Many Requests.

Error Codes

Scopes