QuizBase API#

QuizBase is a multilingual trivia API for developers building quiz apps, learning tools, and interactive experiences.

• 1.4M+ quiz-ready questions blended from 11 open-licensed sources (OpenTDB, OpenTriviaQA, MKQA, Mintaka, NQ-Open, KQA Pro, EntityQuestions, …).
• English and Polish at launch — Polish as a first-class language with reviewed machine translation, not an afterthought. More languages on the roadmap.
• Transparent licensing — every question carries license, licenseUrl, author, source, and modifications.
• Real free tier — Free gives you the full API (every endpoint, all 50k+ questions) with 500 requests/day. No card. Upgrade only when traffic outgrows it.
• Public data dump — CC-licensed questions only, regenerated around major content updates. See /data.
• Three-layer taxonomy — 24 categories, 2,184 curated topics with aliases, 87k+ raw tags.
• Fast under load — verified p95 < 100ms at 50 sustained RPS, holds at 200 RPS burst. Numbers, methodology, raw k6 output: /docs/performance.
• OpenAPI 3.1 spec at /openapi.json + interactive API reference.
• MCP server — on the post-launch roadmap.

Start here#

What’s in this documentation#

• Quickstart — signup, API key, first request
• Authentication — keys (qb_pk_* / qb_sk_*), X-API-Key header, rotation
• Errors and retries — RFC 9457 Problem Details, rate-limit headers, exponential backoff
• API reference — me · usage · random · browse · by id · categories · topics · tags · subcategories · languages · stats · report
• Guides — languages & translations · migrating from OpenTDB · building a Polish quiz app · multi-round quiz · MCP for Claude · rate limits in practice
• SDKs — TypeScript · MCP server · other languages
• FAQ and support

One-line preview#

curl -H "X-API-Key: qb_pk_YOUR_KEY_HERE" \
     "https://quizbase.runriva.com/api/v1/questions/random?amount=1&lang=pl"

Every response includes attribution — we don’t hide where the data came from.