Akinator Game API

Play the classic Akinator guessing game through our API

Quick Start

Start a new Akinator game:

GET https://nexus.drexus.xyz/v1/games/akinator/start?region=en&childMode=false

How to Play

Akinator is a game where you think of a character and the game tries to guess it by asking questions. Follow these steps:

  1. Start a new game and receive a gameId
  2. Answer each question using the /answer endpoint
  3. Continue until Akinator guesses your character
  4. Optionally go back to previous questions or check progress
  5. Delete the game when finished

API Endpoints

GET /v1/games/akinator/start

Start a new Akinator game session.

Query Parameters

Parameter Type Default Description
region string en Language region (en, es, fr, de, etc.)
childMode boolean false Enable child-friendly mode

Example Response

{
  "gameId": "550e8400-e29b-41d4-a716-446655440000",
  "question": "Is your character real?",
  "answers": ["Yes", "No", "Don't know", "Probably", "Probably not"],
  "progress": 0,
  "status": true
}
GET /v1/games/akinator/answer/:gameId

Answer the current question in your game.

Query Parameters

Parameter Type Required Description
answer string Yes yes, no, dont-know, probably, probably-not

Example Request

GET /v1/games/akinator/answer/550e8400-e29b-41d4-a716-446655440000?answer=yes

Response (Game Continues)

{
  "question": "Is your character from a movie?",
  "answers": ["Yes", "No", "Don't know", "Probably", "Probably not"],
  "progress": 15,
  "status": true
}

Response (Game Solved)

{
  "name": "Spider-Man",
  "description": "Marvel superhero with spider powers",
  "photo": "https://...",
  "solved": true,
  "status": false
}
GET /v1/games/akinator/back/:gameId

Go back to the previous question.

Example Response

{
  "question": "Is your character real?",
  "answers": ["Yes", "No", "Don't know", "Probably", "Probably not"],
  "status": true
}
GET /v1/games/akinator/progress/:gameId

Check the current progress of your game (0-100%).

Example Response

{
  "progress": 45,
  "status": true
}
DELETE /v1/games/akinator/game/:gameId

Delete an active game session.

Example Response

204 No Content

Available Regions

Code Language
en English
es Spanish
fr French
de German
it Italian
pt Portuguese
ru Russian
jp Japanese
zh Chinese

Error Codes

Code Description
400 Bad Request - Invalid answer parameter
401 Unauthorized - Invalid or missing API key
404 Not Found - Game ID does not exist
500 Internal Server Error - Game operation failed