Bored API

The Bored API is a free, open-source, no-authentication public API that serves suggestions for things to do when you are bored. The canonical reference implementation is an MEVN (MongoDB / Express / Vue / Node) project maintained by Drew Thoennes at github.com/drewthoennes/Bored-API (MIT licensed). The historically hosted instance at https://www.boredapi.com/ has been intermittently or fully unreachable since June 2024 (originally hosted on Heroku); a community fork maintained by The App Brewery at https://bored-api.appbrewery.com remains actively available for students and consumers. This profile documents the v1 surface (legacy activities-only), the v2 surface (activities + facts + riddles + websites + suggestions), and the App Brewery community mirror, so the API contract is preserved as a historical, self-hostable artifact.

Bored API publishes 5 APIs on the APIs.io network, including Activities API, Facts API, Riddles API, and 2 more. Tagged areas include Activities, Boredom, Community, Development, and Discovery.

The Bored API catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Bored API’s developer surface includes developer portal, GitHub presence, documentation, and 12 more developer resources.

🌐 Visit website 📡 Source on GitHub

39.0/100 thin ▼ -5.2 Agent 19/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6

5 APIs 5 Features 4 Use Cases

ActivitiesBoredomCommunityDevelopmentDiscoveryEducationFactsFreeMEVNNo AuthOpen SourcePublic APIsRecreationRiddlesSuggestionsWebsites

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 39.0/100 · thin

Contract Quality 16.1 / 25

Developer Ergonomics 6.5 / 20

Commercial Clarity 0.0 / 20

Operational Transparency 0.7 / 13

Governance 8.3 / 12

Discoverability 7.4 / 10

Agent readiness — 19/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 0 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 0 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/bored: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 5

Individual APIs this provider publishes, each with its own machine-readable definition.

Bored API Activities API

Random and filtered activity suggestions.

Bored API Facts API

Random or keyed factual snippets (v2 only).

Bored API Riddles API

Random or keyed riddles with difficulty filter (v2 only).

Bored API Suggestions API

Community-submitted content suggestions for review (v2 only).

Bored API Websites API

Random or keyed website recommendations (v2 only).

Open Collections 2

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Bored API

OPEN COLLECTION

Bored API (App Brewery Fork)

OPEN COLLECTION

Features 5

Notable capabilities this provider offers.

Free and open

No API key, no auth, no signup required.

Multi-dimensional filtering

Activities can be filtered by type, participants, price, and accessibility — including min/max ranges.

Versioned surface

V1 (legacy) and v2 (extended with facts, riddles, websites, suggestions) coexist.

Self-hostable

MIT-licensed MEVN stack — clone, npm install, run against a local MongoDB.

Community-extensible

V2 suggestions endpoint accepts new activity, fact, riddle, and website submissions for moderator review.

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Bored Context

0 classes · 5 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Bored API API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Bored API API Rules

12 rules · 8 errors 4 warnings

SPECTRAL

3 properties

JSON SCHEMA

2 fields

EXAMPLE

Scroll for all 10

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Bored Domain Security

TLSv1.3

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Bored Agentic Access

14 operations · 1 acting

AGENTIC

Use Cases 4

What developers build with this provider.

Boredom busters

I'm Bored Alexa skill, Discord bots, browser extensions for spontaneous activity ideas.

Teaching API

Sample API used in many web-development bootcamps (notably The App Brewery course) for fetch/axios/HTTP exercises.

Mobile apps

iOS and Android apps that surface random activities to users.

Decision support

Helper tools that recommend low-cost, low-participant activities when users can't decide what to do.

Integrations 5

Pre-built integrations with other platforms and tools.

Amazon Alexa

I'm Bored Alexa skill consuming the Bored API for spoken suggestions.

Python (PyPI)

bored and bored-api Python wrappers on PyPI.

Kotlin

CMDR_Tvis Kotlin wrapper on GitLab.

iOS App Store

Bored — Find What to Do iOS app.

The App Brewery

Used as the canonical fetch/axios teaching API in The App Brewery's web-development course.

Resources

Get Started 1

Portal, sign-up, and the first successful call

Portal

Portal

Documentation 1

The organization behind the API

Website

Website

Other 1

Properties that don't map to a standard resource type

PublicAPIsListing

PublicAPIsListing

Source (apis.yml)

aid: bored
name: Bored API
description: The Bored API is a free, open-source, no-authentication public API that serves suggestions for things to do when
  you are bored. The canonical reference implementation is an MEVN (MongoDB / Express / Vue / Node) project maintained by
  Drew Thoennes at github.com/drewthoennes/Bored-API (MIT licensed). The historically hosted instance at https://www.boredapi.com/
  has been intermittently or fully unreachable since June 2024 (originally hosted on Heroku); a community fork maintained
  by The App Brewery at https://bored-api.appbrewery.com remains actively available for students and consumers. This profile
  documents the v1 surface (legacy activities-only), the v2 surface (activities + facts + riddles + websites + suggestions),
  and the App Brewery community mirror, so the API contract is preserved as a historical, self-hostable artifact.
url: https://github.com/drewthoennes/Bored-API
humanURL: https://github.com/drewthoennes/Bored-API
accessModel:
  pricing: unknown
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Unknown
  confidence: low
  source: []
  generated: '2026-07-22'
  method: derived
specificationVersion: '0.20'
type: Index
access: 3rd-Party
kind: opensource
created: '2026-05-28'
modified: '2026-05-30'
position: Consumer
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/bored.png
x-type: opensource
x-status: hosted-instance-deprecated
x-source: public-apis/public-apis
x-category: Development
x-tier: 3
x-tier-reason: bulk-registered-from-public-apis
tags:
- Activities
- Boredom
- Community
- Development
- Discovery
- Education
- Facts
- Free
- MEVN
- No Auth
- Open Source
- Public APIs
- Recreation
- Riddles
- Suggestions
- Websites
apis:
- aid: bored:bored-activities-api
  name: Bored API Activities API
  description: Random and filtered activity suggestions.
  humanURL: https://github.com/drewthoennes/Bored-API
  baseURL: https://www.boredapi.com
  tags:
  - Activities
  properties:
  - type: OpenAPI
    url: openapi/bored-activities-api-openapi.yml
  - type: Documentation
    url: https://github.com/drewthoennes/Bored-API#readme
  - type: SourceCode
    url: https://github.com/drewthoennes/Bored-API
  - type: JSONSchema
    url: json-schema/bored-activity-v1-schema.json
  - type: JSONSchema
    url: json-schema/bored-activity-v2-schema.json
  - type: JSONSchema
    url: json-schema/bored-fact-schema.json
  - type: JSONSchema
    url: json-schema/bored-riddle-schema.json
  - type: JSONSchema
    url: json-schema/bored-website-schema.json
  - type: JSONSchema
    url: json-schema/bored-suggestion-schema.json
  - type: JSONStructure
    url: json-structure/bored-activity-v1-structure.json
  - type: JSONStructure
    url: json-structure/bored-activity-v2-structure.json
  - type: JSONStructure
    url: json-structure/bored-fact-structure.json
  - type: JSONStructure
    url: json-structure/bored-riddle-structure.json
  - type: JSONStructure
    url: json-structure/bored-website-structure.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v1-example.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v1-filtered-example.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v2-example.json
  - type: Examples
    url: examples/bored-api-get-activity-by-key-v2-example.json
  - type: Examples
    url: examples/bored-api-get-random-fact-example.json
  - type: Examples
    url: examples/bored-api-get-random-riddle-example.json
  - type: Examples
    url: examples/bored-api-get-random-website-example.json
  - type: Examples
    url: examples/bored-api-submit-suggestion-example.json
  - type: Documentation
    url: https://bored-api.appbrewery.com/
  - type: RateLimits
    url: https://bored-api.appbrewery.com/
  - type: Examples
    url: examples/bored-appbrewery-get-random-example.json
  - type: Examples
    url: examples/bored-appbrewery-filter-example.json
- aid: bored:bored-facts-api
  name: Bored API Facts API
  description: Random or keyed factual snippets (v2 only).
  humanURL: https://github.com/drewthoennes/Bored-API
  baseURL: https://www.boredapi.com
  tags:
  - Facts
  properties:
  - type: OpenAPI
    url: openapi/bored-facts-api-openapi.yml
  - type: Documentation
    url: https://github.com/drewthoennes/Bored-API#readme
  - type: SourceCode
    url: https://github.com/drewthoennes/Bored-API
  - type: JSONSchema
    url: json-schema/bored-activity-v1-schema.json
  - type: JSONSchema
    url: json-schema/bored-activity-v2-schema.json
  - type: JSONSchema
    url: json-schema/bored-fact-schema.json
  - type: JSONSchema
    url: json-schema/bored-riddle-schema.json
  - type: JSONSchema
    url: json-schema/bored-website-schema.json
  - type: JSONSchema
    url: json-schema/bored-suggestion-schema.json
  - type: JSONStructure
    url: json-structure/bored-activity-v1-structure.json
  - type: JSONStructure
    url: json-structure/bored-activity-v2-structure.json
  - type: JSONStructure
    url: json-structure/bored-fact-structure.json
  - type: JSONStructure
    url: json-structure/bored-riddle-structure.json
  - type: JSONStructure
    url: json-structure/bored-website-structure.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v1-example.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v1-filtered-example.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v2-example.json
  - type: Examples
    url: examples/bored-api-get-activity-by-key-v2-example.json
  - type: Examples
    url: examples/bored-api-get-random-fact-example.json
  - type: Examples
    url: examples/bored-api-get-random-riddle-example.json
  - type: Examples
    url: examples/bored-api-get-random-website-example.json
  - type: Examples
    url: examples/bored-api-submit-suggestion-example.json
  - type: Documentation
    url: https://bored-api.appbrewery.com/
  - type: RateLimits
    url: https://bored-api.appbrewery.com/
  - type: Examples
    url: examples/bored-appbrewery-get-random-example.json
  - type: Examples
    url: examples/bored-appbrewery-filter-example.json
- aid: bored:bored-riddles-api
  name: Bored API Riddles API
  description: Random or keyed riddles with difficulty filter (v2 only).
  humanURL: https://github.com/drewthoennes/Bored-API
  baseURL: https://www.boredapi.com
  tags:
  - Riddles
  properties:
  - type: OpenAPI
    url: openapi/bored-riddles-api-openapi.yml
  - type: Documentation
    url: https://github.com/drewthoennes/Bored-API#readme
  - type: SourceCode
    url: https://github.com/drewthoennes/Bored-API
  - type: JSONSchema
    url: json-schema/bored-activity-v1-schema.json
  - type: JSONSchema
    url: json-schema/bored-activity-v2-schema.json
  - type: JSONSchema
    url: json-schema/bored-fact-schema.json
  - type: JSONSchema
    url: json-schema/bored-riddle-schema.json
  - type: JSONSchema
    url: json-schema/bored-website-schema.json
  - type: JSONSchema
    url: json-schema/bored-suggestion-schema.json
  - type: JSONStructure
    url: json-structure/bored-activity-v1-structure.json
  - type: JSONStructure
    url: json-structure/bored-activity-v2-structure.json
  - type: JSONStructure
    url: json-structure/bored-fact-structure.json
  - type: JSONStructure
    url: json-structure/bored-riddle-structure.json
  - type: JSONStructure
    url: json-structure/bored-website-structure.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v1-example.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v1-filtered-example.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v2-example.json
  - type: Examples
    url: examples/bored-api-get-activity-by-key-v2-example.json
  - type: Examples
    url: examples/bored-api-get-random-fact-example.json
  - type: Examples
    url: examples/bored-api-get-random-riddle-example.json
  - type: Examples
    url: examples/bored-api-get-random-website-example.json
  - type: Examples
    url: examples/bored-api-submit-suggestion-example.json
  - type: Documentation
    url: https://bored-api.appbrewery.com/
  - type: RateLimits
    url: https://bored-api.appbrewery.com/
  - type: Examples
    url: examples/bored-appbrewery-get-random-example.json
  - type: Examples
    url: examples/bored-appbrewery-filter-example.json
- aid: bored:bored-suggestions-api
  name: Bored API Suggestions API
  description: Community-submitted content suggestions for review (v2 only).
  humanURL: https://github.com/drewthoennes/Bored-API
  baseURL: https://www.boredapi.com
  tags:
  - Suggestions
  properties:
  - type: OpenAPI
    url: openapi/bored-suggestions-api-openapi.yml
  - type: Documentation
    url: https://github.com/drewthoennes/Bored-API#readme
  - type: SourceCode
    url: https://github.com/drewthoennes/Bored-API
  - type: JSONSchema
    url: json-schema/bored-activity-v1-schema.json
  - type: JSONSchema
    url: json-schema/bored-activity-v2-schema.json
  - type: JSONSchema
    url: json-schema/bored-fact-schema.json
  - type: JSONSchema
    url: json-schema/bored-riddle-schema.json
  - type: JSONSchema
    url: json-schema/bored-website-schema.json
  - type: JSONSchema
    url: json-schema/bored-suggestion-schema.json
  - type: JSONStructure
    url: json-structure/bored-activity-v1-structure.json
  - type: JSONStructure
    url: json-structure/bored-activity-v2-structure.json
  - type: JSONStructure
    url: json-structure/bored-fact-structure.json
  - type: JSONStructure
    url: json-structure/bored-riddle-structure.json
  - type: JSONStructure
    url: json-structure/bored-website-structure.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v1-example.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v1-filtered-example.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v2-example.json
  - type: Examples
    url: examples/bored-api-get-activity-by-key-v2-example.json
  - type: Examples
    url: examples/bored-api-get-random-fact-example.json
  - type: Examples
    url: examples/bored-api-get-random-riddle-example.json
  - type: Examples
    url: examples/bored-api-get-random-website-example.json
  - type: Examples
    url: examples/bored-api-submit-suggestion-example.json
  - type: Documentation
    url: https://bored-api.appbrewery.com/
  - type: RateLimits
    url: https://bored-api.appbrewery.com/
  - type: Examples
    url: examples/bored-appbrewery-get-random-example.json
  - type: Examples
    url: examples/bored-appbrewery-filter-example.json
- aid: bored:bored-websites-api
  name: Bored API Websites API
  description: Random or keyed website recommendations (v2 only).
  humanURL: https://github.com/drewthoennes/Bored-API
  baseURL: https://www.boredapi.com
  tags:
  - Websites
  properties:
  - type: OpenAPI
    url: openapi/bored-websites-api-openapi.yml
  - type: Documentation
    url: https://github.com/drewthoennes/Bored-API#readme
  - type: SourceCode
    url: https://github.com/drewthoennes/Bored-API
  - type: JSONSchema
    url: json-schema/bored-activity-v1-schema.json
  - type: JSONSchema
    url: json-schema/bored-activity-v2-schema.json
  - type: JSONSchema
    url: json-schema/bored-fact-schema.json
  - type: JSONSchema
    url: json-schema/bored-riddle-schema.json
  - type: JSONSchema
    url: json-schema/bored-website-schema.json
  - type: JSONSchema
    url: json-schema/bored-suggestion-schema.json
  - type: JSONStructure
    url: json-structure/bored-activity-v1-structure.json
  - type: JSONStructure
    url: json-structure/bored-activity-v2-structure.json
  - type: JSONStructure
    url: json-structure/bored-fact-structure.json
  - type: JSONStructure
    url: json-structure/bored-riddle-structure.json
  - type: JSONStructure
    url: json-structure/bored-website-structure.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v1-example.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v1-filtered-example.json
  - type: Examples
    url: examples/bored-api-get-random-activity-v2-example.json
  - type: Examples
    url: examples/bored-api-get-activity-by-key-v2-example.json
  - type: Examples
    url: examples/bored-api-get-random-fact-example.json
  - type: Examples
    url: examples/bored-api-get-random-riddle-example.json
  - type: Examples
    url: examples/bored-api-get-random-website-example.json
  - type: Examples
    url: examples/bored-api-submit-suggestion-example.json
  - type: Documentation
    url: https://bored-api.appbrewery.com/
  - type: RateLimits
    url: https://bored-api.appbrewery.com/
  - type: Examples
    url: examples/bored-appbrewery-get-random-example.json
  - type: Examples
    url: examples/bored-appbrewery-filter-example.json
common:
- type: AgenticAccess
  url: agentic-access/bored-agentic-access.yml
- type: DomainSecurity
  url: security/bored-domain-security.yml
- type: Website
  url: https://www.boredapi.com/
  name: Bored API Website (Historic)
- type: Portal
  url: https://bored-api.appbrewery.com/
  name: App Brewery Hosted Mirror
- type: GitHub
  url: https://github.com/drewthoennes/Bored-API
  name: Canonical GitHub Repository
- type: SourceCode
  url: https://github.com/drewthoennes/Bored-API
  name: Drew Thoennes Bored-API Source
- type: Documentation
  url: https://github.com/drewthoennes/Bored-API#readme
  name: README Documentation
- type: License
  url: https://github.com/drewthoennes/Bored-API/blob/master/license
  name: MIT License
- type: PublicAPIsListing
  url: https://github.com/public-apis/public-apis
  name: Listed in public-apis/public-apis
- type: SDKs
  url: https://pypi.org/project/bored/
  name: Python wrapper (bored on PyPI)
- type: SDKs
  url: https://pypi.org/project/bored-api/
  name: Alternate Python wrapper (bored-api on PyPI)
- type: SDKs
  url: https://gitlab.com/CMDR_Tvis/bored-api
  name: Kotlin wrapper
- type: JSONLD
  url: json-ld/bored-context.jsonld
- type: Spectral
  url: rules/bored-rules.yml
- type: Vocabulary
  url: vocabulary/bored-vocabulary.yml
- type: Features
  data:
  - name: Free and open
    description: No API key, no auth, no signup required.
  - name: Multi-dimensional filtering
    description: Activities can be filtered by type, participants, price, and accessibility — including min/max ranges.
  - name: Versioned surface
    description: V1 (legacy) and v2 (extended with facts, riddles, websites, suggestions) coexist.
  - name: Self-hostable
    description: MIT-licensed MEVN stack — clone, npm install, run against a local MongoDB.
  - name: Community-extensible
    description: V2 suggestions endpoint accepts new activity, fact, riddle, and website submissions for moderator review.
- type: UseCases
  data:
  - name: Boredom busters
    description: I'm Bored Alexa skill, Discord bots, browser extensions for spontaneous activity ideas.
  - name: Teaching API
    description: Sample API used in many web-development bootcamps (notably The App Brewery course) for fetch/axios/HTTP exercises.
  - name: Mobile apps
    description: iOS and Android apps that surface random activities to users.
  - name: Decision support
    description: Helper tools that recommend low-cost, low-participant activities when users can't decide what to do.
  description: Common use cases for the Bored API across hobbyist and educational projects.
- type: Integrations
  data:
  - name: Amazon Alexa
    description: I'm Bored Alexa skill consuming the Bored API for spoken suggestions.
  - name: Python (PyPI)
    description: bored and bored-api Python wrappers on PyPI.
  - name: Kotlin
    description: CMDR_Tvis Kotlin wrapper on GitLab.
  - name: iOS App Store
    description: Bored — Find What to Do iOS app.
  - name: The App Brewery
    description: Used as the canonical fetch/axios teaching API in The App Brewery's web-development course.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com