Bored API · Schema
BoredSuggestion
Suggestion request body. Exactly one of activity, fact, riddle, or website must be supplied.
ActivitiesBoredomCommunityDevelopmentDiscoveryEducationFactsFreeMEVNNo AuthOpen-SourcePublic APIsRecreationRiddlesSuggestionsWebsites
Properties
| Name | Type | Description |
|---|---|---|
| activity | object | |
| fact | object | |
| riddle | object | |
| website | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://api-evangelist.github.io/bored/json-schema/bored-suggestion-schema.json",
"title": "BoredSuggestion",
"description": "Suggestion request body. Exactly one of activity, fact, riddle, or website must be supplied.",
"type": "object",
"oneOf": [
{ "required": ["activity"] },
{ "required": ["fact"] },
{ "required": ["riddle"] },
{ "required": ["website"] }
],
"properties": {
"activity": {
"type": "object",
"required": ["activity", "type", "participants"],
"properties": {
"activity": { "type": "string" },
"type": {
"type": "string",
"enum": [
"education",
"recreational",
"social",
"diy",
"charity",
"cooking",
"relaxation",
"music",
"busywork"
]
},
"participants": { "type": "integer", "minimum": 1 }
}
},
"fact": {
"type": "object",
"required": ["fact", "source"],
"properties": {
"fact": { "type": "string" },
"source": { "type": "string", "format": "uri" }
}
},
"riddle": {
"type": "object",
"required": ["question", "answer", "source"],
"properties": {
"question": { "type": "string" },
"answer": { "type": "string" },
"source": { "type": "string", "format": "uri" }
}
},
"website": {
"type": "object",
"required": ["url", "description"],
"properties": {
"url": { "type": "string", "format": "uri" },
"description": { "type": "string" }
}
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/bored-suggestion"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.