Are the answers checked?

Yes. Every answer has been verified, including the maths and logic riddles.

Which categories and difficulties?

Classic, logic, wordplay, maths, animals, nature, objects and food, each tagged easy, medium or hard.

Can I hide the answer?

Yes. Pass include_answer=false to get questions without spoilers, then fetch the answer by id when the user gives up.

Yes. Full-text search, category and difficulty filters, paging, random batches of up to 20 and lookup by id.

What does a call cost?

1 token. The free plan covers 500 riddles a month.

EntertainmentMAINTAINED1 token / call

Riddles API

176 curated riddles with answers in 8 categories and three difficulties, built for quiz and game UIs

176 curated riddles with answers across 8 categories — classic, logic, wordplay, math, animals, nature, objects and food — each tagged easy, medium or hard. Pull random riddles (up to 20 at once), full-text search, filter by category or difficulty, page through everything, or fetch one by id. Built for quiz and game UIs: pass include_answer=false to serve questions without spoiling the solution, then reveal it via the by-id endpoint. Every riddle is family-friendly and every answer has been checked for correctness.

Every call needs an X-Api-Key header. A free key includes 500 tokens a month, no card required. 1 token per call, so the free plan covers about 500 calls a month.

Start free — 500 tokens / mo →See all plans

No credit card requiredAccess to 125+ APIsCancel anytime

response.json

{
  "query": "GET /v1/riddles/random?category=food",
  "question": "What kind of cup can't hold water?",
  "answer": "A cupcake.",
  "catalog": "176 riddles / 8 categories / 3 difficulties"
}

Production Ready: Battle-tested infrastructure with a 99.9% uptime SLA. Rate limits are generous, responses are consistent.
Simple Integration: Standard REST + JSON. Works with any HTTP client. Copy-ready code snippets in 4 languages.
One Key, 125+ APIs: Your DataAndAPIs subscription unlocks every API on the platform — anime, finance, sports, and more.

Use cases for Riddles API

Serve a riddle of the day with the answer hidden until the user taps.
Build a riddle game with difficulty progression and category rounds.
Fill classroom and party apps with checked, family-friendly riddles.
Pull up to 20 riddles at once for a printable sheet.

Riddles API endpoints

Every endpoint with its parameters and a real example response.

OpenAPI definition Postman workspace

GETGet Riddle
GETList Categories
GETList Riddles
GETRandom Riddle

GETGet Riddle

https://api-riddles.dataandapis.com/v1/riddles/{id}

Path parameters

Parameter	Example
id	1	Required

Example request

curl "https://api-riddles.dataandapis.com/v1/riddles/1" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "id": 154,
  "category": "objects",
  "difficulty": "medium",
  "question": "What has cities but no houses, forests but no trees, and rivers without water?",
  "answer": "A map."
}

GETList Categories

https://api-riddles.dataandapis.com/v1/riddles/categories

This endpoint takes no parameters.

Example request

curl "https://api-riddles.dataandapis.com/v1/riddles/categories" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "count": 8,
  "total_riddles": 176,
  "difficulties": {
    "easy": 70,
    "medium": 76,
    "hard": 30
  },
  "categories": [
    {
      "name": "animals",
      "riddles": 19
    },
    {
      "name": "classic",
      "riddles": 36
    },
    {
      "name": "food",
      "riddles": 14
    },
    {
      "name": "logic",
      "riddles": 30
    },
    {
      "name": "math",
…

Show full response

{
  "ok": true,
  "count": 8,
  "total_riddles": 176,
  "difficulties": {
    "easy": 70,
    "medium": 76,
    "hard": 30
  },
  "categories": [
    {
      "name": "animals",
      "riddles": 19
    },
    {
      "name": "classic",
      "riddles": 36
    },
    {
      "name": "food",
      "riddles": 14
    },
    {
      "name": "logic",
      "riddles": 30
    },
    {
      "name": "math",
      "riddles": 20
    },
    {
      "name": "nature",
      "riddles": 16
    },
    {
      "name": "objects",
      "riddles": 15
    },
    {
      "name": "wordplay",
      "riddles": 26
    }
  ]
}

GETList Riddles

https://api-riddles.dataandapis.com/v1/riddles

Query parameters

Parameter	Example
category	logic	Optional
difficulty	hard	Optional
include_answer	false	Optional
limit	20	Optional
page	1	Optional
search	map	Optional

Example request

curl "https://api-riddles.dataandapis.com/v1/riddles?category=logic&difficulty=hard&include_answer=false&limit=20&page=1&search=map" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "total": 3,
  "page": 1,
  "limit": 20,
  "count": 3,
  "results": [
    {
      "id": 16,
      "category": "logic",
      "difficulty": "hard",
      "question": "A girl has as many brothers as sisters, but each brother has only half as many brothers as sisters. How many brothers and sisters are in the family?"
    },
    {
      "id": 17,
      "category": "logic",
      "difficulty": "hard",
      "question": "Two fathers and two sons go fishing and each catches one fish, yet they bring home only three fish. How?"
    },
    {
      "id": 20,
      "category": "logic",
      "difficulty": "hard",
      "question": "Forward I am heavy, but backward I am not. What am I?"
    }
  ]
}

GETRandom Riddle

https://api-riddles.dataandapis.com/v1/riddles/random

Query parameters

Parameter	Example
amount	1	Optional
category	logic	Optional
difficulty	easy	Optional
include_answer	false	Optional
search		Optional

Example request

curl "https://api-riddles.dataandapis.com/v1/riddles/random?amount=1&category=logic&difficulty=easy&include_answer=false" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "count": 1,
  "results": [
    {
      "id": 165,
      "category": "food",
      "difficulty": "easy",
      "question": "What kind of cup can't hold water?",
      "answer": "A cupcake."
    }
  ]
}

Where the data comes from

Source: Curated riddle set bundled in the worker.
Freshness: Extended with API releases.

One install. Every endpoint.

No proprietary SDKs needed. Any HTTP client works. Pick your language and paste.

3languages

4endpoints

RESTarchitecture

1key for all APIs

Fully typed responses — auto-completion in your IDE
Tracks the API in lockstep — new endpoints land same day
One key works across 125+ APIs on the platform

import axios from 'axios';

const { data } = await axios.get(
  'https://api-riddles.dataandapis.com/v1/riddles/{id}',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Riddles API · X-Api-Key

Explore the endpoints

Browse request parameters and inspect live example responses.

Available Endpoints

Request Parameters

API URL

Headers

X-Api-Key

Path Parameters

Target:

Client:

import axios from 'axios';

const url = 'https://api-riddles.dataandapis.com/v1/riddles/{id}';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});