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 19 Aug 2026

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 19 Aug 2026, 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

Parameter	Type	Required	Description
`type`	string	Optional	education, recreational, social, diy, charity, cooking, relaxation, music or busywork. `recreational`
`participants`	integer	Optional	Exact number of people required. `2`
`price`	float	Optional	Cost factor from 0 (free) to 1 (expensive). `0`
`accessibility`	float	Optional	Difficulty 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.

Alternatives to Bored API

If Bored API does not fit, these developer & testing apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.

API	What it does	Auth	CORS	Last verified
GitHub REST API	GitHub REST API with no key for public data: repository details, users, issues, releases and commits. 60 req/hour unauthenticated, 5,000 with a token.	No key	Yes	19 Aug 2026
JSONPlaceholder	Free fake REST API for testing and prototyping. Posts, comments, users and todos with full GET, POST, PUT and DELETE support. No key. Real curl examples.	No key	Yes	19 Aug 2026
Postman Echo	Postman Echo reflects your HTTP request back as JSON: headers, body, query params and auth. Free, no key, ideal for debugging clients. Real POST example.	No key	No	19 Aug 2026
DummyJSON	Free fake REST API with realistic products, users, carts, recipes and auth. Supports search, pagination, sorting and POST. No key. Tested GET and POST examples.	No key	Yes	19 Aug 2026
Bundlephobia	Free Bundlephobia API with no key: minified and gzipped size of any npm package, plus dependency count, tree-shakeability and download time estimates. Tested.	No key	Yes	20 Aug 2026
cdnjs	Free cdnjs API with no key: search 4,000+ front-end libraries, get versions, file listings and SRI hashes for secure script tags. Tested curl example.	No key	Yes	20 Aug 2026

All Developer & Testing APIs

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