Bored API

bored-api.appbrewery.com · Developer Tools

Developer Tools No Auth Free & Open Fun Activities Developer Tools

Suggests random activities to fight boredom — filter by type, number of participants, and budget. Great for beginner API practice. No API key required.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Random activity

Get a random activity suggestion.

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

Hover any highlighted part to learn what it does

curl -X GET "https://bored-api.appbrewery.com/random"

import requests
response = requests.get(
    "https://bored-api.appbrewery.com/random",
)
print(response.json())

const url = 'https://bored-api.appbrewery.com/random';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://bored-api.appbrewery.com/random"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://bored-api.appbrewery.com/random")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://bored-api.appbrewery.com/random";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Filter activities

Get social activities for 2 people.

https://bored-api.appbrewery.com/filter?type=social&participants=2

Hover any highlighted part to learn what it does

curl -X GET "https://bored-api.appbrewery.com/filter?type=social&participants=2"

import requests
params = {
    "type": "social",
    "participants": "2"
}
response = requests.get(
    "https://bored-api.appbrewery.com/filter",
    params=params,
)
print(response.json())

const url = new URL('https://bored-api.appbrewery.com/filter');
url.searchParams.set('type', 'social');
url.searchParams.set('participants', '2');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://bored-api.appbrewery.com/filter")
	q := baseURL.Query()
	q.Set("type", "social")
	q.Set("participants", "2")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://bored-api.appbrewery.com/filter")
uri.query = URI.encode_www_form({
  "type" => "social",
  "participants" => "2"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://bored-api.appbrewery.com/filter?" . http_build_query([
    "type" => "social",
    "participants" => "2"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

No API key needed
Random: GET https://bored-api.appbrewery.com/random
Types: education, recreational, social, diy, charity, cooking, relaxation, music, busywork
Filter: GET /filter?type=cooking&participants=1
Budget filter: ?minprice=0&maxprice=0.1 (0=free)

Open documentation ↗