Skip to main content

GETTING STARTED

Your first Trivio question in about five minutes.

Create a free key in the dashboard, keep it on your server, then make one authenticated request. No credit card or SDK is required.

ACCOUNT

Create or sign in to your Trivio account

Your normal Trivio account owns the API organization, keys, usage, plan, and connected applications. Opening the dashboard while signed out returns you there after authentication.

Create your free account

API KEY

Name and create a key

  1. Open API keys in the developer dashboard.
  2. Use a descriptive name such as Local prototype or Production backend.
  3. Select Create API key, then copy the secret immediately.

The complete key is shown once. Trivio stores only a one-way digest and cannot recover it later. If it is lost, revoke it and create another.

SERVER ENVIRONMENT

Store the key outside your source code

Set an environment variable in your local shell or deployment secret manager. Never ship a Trivio API key in browser JavaScript, a mobile bundle, a public repository, or a model prompt.

Environment variable
export TRIVIO_API_KEY="trv_live_your_key"

FIRST REQUEST

Request three answer-free questions

Use the Bearer header from your server. The example asks for three multiple-choice history questions; remove either filter to broaden the random selection.

cURL quickstart
curl "https://206-81-1-100.sslip.io/api/v2/questions?limit=3&category=history&type=multiple_choice" \
  -H "Authorization: Bearer $TRIVIO_API_KEY"

VERIFY

Confirm the payload and quota headers

A successful response is HTTP 200, includes a questions array, and intentionally omits the correct answer. Inspect X-API-Quota-Remaining to confirm usage is being counted.

Answer-free response
{
  "questions": [{
    "id": "018f...",
    "text": "Which planet is known as the Red Planet?",
    "options": [
      { "id": "opt_1", "text": "Mars" },
      { "id": "opt_2", "text": "Venus" },
      { "id": "opt_3", "text": "Jupiter" },
      { "id": "opt_4", "text": "Mercury" }
    ],
    "category": "Science & Nature",
    "type": "multiple_choice"
  }],
  "count": 1
}

NEXT

Choose what your product needs next.