openapi: 3.1.0
info:
title: Open Trivia DB Categories Tokens API
description: Free JSON API providing trivia questions across multiple categories, difficulties, and types. No API key is required. Supports session tokens to avoid duplicate questions across requests, multiple response encodings, and rate limiting of one request per IP every 5 seconds.
version: '1.0'
contact:
name: Open Trivia DB
url: https://opentdb.com
license:
name: Creative Commons Attribution-ShareAlike 4.0 International
url: https://creativecommons.org/licenses/by-sa/4.0/
servers:
- url: https://opentdb.com
description: Open Trivia DB Production
tags:
- name: Tokens
description: Manage session tokens to track served questions.
paths:
/api_token.php:
get:
tags:
- Tokens
summary: Manage session tokens
description: Request a new session token, reset an existing one, or check token status. Tokens prevent duplicate questions across requests for 6 hours of inactivity.
operationId: manageToken
parameters:
- name: command
in: query
required: true
description: Token operation.
schema:
type: string
enum:
- request
- reset
- name: token
in: query
description: Existing token (required when command is reset).
schema:
type: string
responses:
'200':
description: Token response.
externalDocs:
description: Open Trivia DB API Documentation
url: https://opentdb.com/api_config.php