Riddles API

Frequently Asked Questions

• Can I use the Riddles API for commercial purposes?

  Yes, but you must have a premium subscription. Commercial use of the Riddles API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.

• How do I get an API key and start using the Riddles API?

  Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.

• What happens if I exceed my quota for the month?

  Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.

• What happens if a request to the Riddles API fails?

  The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.

• How do I get more than one riddle in a single request?

  Use the optional limit parameter on the /v1/riddles endpoint to request between 1 and 20 riddles at once (the default is 1). The limit parameter is a premium feature, so a paid plan is required to return more than one riddle per call.

• What fields does each riddle object include?

  Each riddle in the returned JSON array contains a title (the name of the riddle), a question (the riddle text), and an answer (the solution). If a request fails, the response is an error instead of a riddle array.

• How many riddles can I access, and how does that change with a paid plan?

  The free tier provides access to 100 riddles, while premium plans unlock more than 10,000 riddles. The endpoint returns a random selection on each call, making it well suited for quiz or trivia features.

• What other entertainment APIs pair well with Riddles for an app?

  Riddles works nicely alongside other lighthearted content endpoints such as the Jokes, Dad Jokes, and Trivia APIs to build a richer entertainment experience.