BYTETOOLS

Bored API

Free API that suggests a random activity when you're bored. Filter by type, participants, price and accessibility. No key required. Tested curl example.

No API key requiredHTTPSFree tier

Endpoint tested and returned HTTP 200 on 2026-08-19

What is the Bored API?

The Bored API is a free, key-free API that returns a random activity suggestion. Activities can be filtered by type, number of participants, price and accessibility, making it a common choice for beginner projects.

The Bored API returns a single suggested activity with metadata describing it — how many people it needs, roughly what it costs, and how accessible it is. It is one of the most-used APIs in beginner tutorials because the response is tiny and the concept needs no explanation.

It is worth knowing that the original boredapi.com domain became unreliable and the community moved to a maintained mirror. The example on this page uses the mirror that responded successfully during verification, which is exactly the kind of change static API lists tend to miss.

Quick facts

Base URL
https://bored-api.appbrewery.com
Authentication
No key required.
Rate limit
No published limit.
Pricing
Free.
CORS
Not enabled — call it from your server
Official docs
Read the docs

How to use the Bored API

Every request below was executed against the live API on 2026-08-19, and the response shown is the real body it returned — not an illustration.

1. Get a random activity suggestion

GET https://bored-api.appbrewery.com/random

curl
curl 'https://bored-api.appbrewery.com/random'
JavaScript (fetch)
const res = await fetch("https://bored-api.appbrewery.com/random");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);
Python (requests)
import requests

res = requests.get("https://bored-api.appbrewery.com/random", timeout=20)
res.raise_for_status()
print(res.json())
Response — HTTP 200
{
  "activity": "Have a paper airplane contest with some friends",
  "availability": 0.05,
  "type": "social",
  "participants": 4,
  "price": 0.02,
  "accessibility": "Few to no challenges",
  "duration": "minutes",
  "kidFriendly": true,
  "link": "",
  "key": "8557562"
}

Parameters

ParameterTypeRequiredDescription
typestringOptionaleducation, recreational, social, diy, charity, cooking, relaxation, music or busywork. recreational
participantsintegerOptionalExact number of people required. 2
pricefloatOptionalCost factor from 0 (free) to 1 (expensive). 0
accessibilityfloatOptionalDifficulty factor from 0 (easy) to 1 (hard). 0.5

Response fields

activitystring
The suggested activity text.
typestring
Category the activity belongs to.
participantsinteger
How many people it needs.
pricefloat
Relative cost, 0 to 1.
accessibilityfloat
Relative difficulty or accessibility, 0 to 1.

What you can build with the Bored API

  • Build a beginner fetch or async/await tutorial project
  • Add a random suggestion button to a lifestyle or wellbeing app
  • Generate activity ideas filtered by group size for event planning
  • Practise query parameter handling with a simple, forgiving API

Common errors and how to fix them

404 or empty result

Filters were too narrow and matched no activity.

Fix: Loosen the filters — combining exact participants with a specific type often matches nothing.

DNS or connection failure on boredapi.com

The original domain is no longer reliable.

Fix: Use the maintained mirror shown in the example on this page.

Bored API — frequently asked questions

Is the Bored API still working?

The original boredapi.com host became unreliable, but a maintained community mirror is available and is what the verified example on this page uses.

Does the Bored API need an API key?

No. It requires no key, no signup and no authentication, which is part of why it is so common in beginner tutorials.

Can I filter activities by group size?

Yes, with the `participants` parameter. Note that it matches exactly, so combining a specific participant count with a narrow type can return no results.

What do the price and accessibility values mean?

Both are relative factors from 0 to 1. For price, 0 is free and 1 is expensive. For accessibility, 0 is easy to do and 1 is difficult, typically because it needs equipment or planning.

Tools that pair with this API

JSON Formatter

Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.

Random Number Generator

Generate random numbers in any range with cryptographically secure randomness. Multiple numbers, no-repeat mode, sorting, plus dice and coin presets.

Bored API is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 2026-08-19; always check the official documentation before relying on this API in production, as terms and limits can change.