Bored API Activity Fetcher

Fetches activity suggestions from the Bored API (App Brewery mirror) — random, filtered by type/participants, or looked up by key — completely no API key required.

Sourced from the Bored API by App Brewery (bored-api.appbrewery.com).

Input

Field	Type	Required	Default	Description
mode	string	no	random	How to query: random, filter, or key.
count	integer	no	5	Number of random activities to fetch (1–50). Only used in random mode.
type	string	no	—	Activity type filter (education, recreational, social, charity, cooking, relaxation, busywork). Used in filter mode.
participants	integer	no	—	Participant count filter (1, 2, 3, 4, 5, 6, 8). Used in filter mode.
key	string	no	—	Numeric activity key (e.g. "3943506"). Required in key mode.
includeSummary	boolean	no	true	If true, also emit one summary record at the end listing all activities found.
timeoutSeconds	integer	no	30	HTTP timeout per API request (1–120).

Input examples

Random activities (default mode):

{
  "mode": "random",
  "count": 5,
  "includeSummary": true
}

Filter by type and participants:

{
  "mode": "filter",
  "type": "recreational",
  "participants": 1,
  "includeSummary": true
}

Lookup by key:

{
  "mode": "key",
  "key": "3943506",
  "includeSummary": true
}

Output

One dataset item per activity (fields: activity, availability, type, participants, price, accessibility, duration, kidFriendly, link, key, sourceUrl) plus optional summary item(s) per mode (queryType, queryValue, activityCount, activities). Failed lookups emit an item with an error field.

Each activity emitted also charges activity-fetched event (PAY_PER_EVENT at $0.0005).

The overview dataset view shows queryType, queryValue, activity, type, participants, price, availability, accessibility, duration, kidFriendly, key, link, activityCount, and error.

Usage

cd bored-api-activity-fetcher
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
echo '{"mode": "random", "count": 5}' > INPUT.json
.venv/bin/python src/main.py

Or with the Apify CLI:

$apify run --input-file INPUT.json

Pricing

PAY_PER_EVENT — $0.0005 per activity-fetched event (one activity suggestion).

Notes

• The Bored API is keyless (no registration needed).
• The canonical boredapi.com host is unreliable; this actor uses the verified working bored-api.appbrewery.com mirror.
• The /filter endpoint requires at least type or participants to be specified.
• Valid participant counts: 1, 2, 3, 4, 5, 6, 8 (7 is not supported by the API).
• The /filter endpoint returns HTTP 404 with a JSON error body when no activities match the given filters.
• Rate limit: 100 requests per 15 minutes per the App Brewery documentation.

Related actors

• Open-Meteo Weather — general weather forecasts (Open-Meteo API)
• NWS Weather Alerts Fetcher — active U.S. weather alerts (NOAA API)