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)

What can you build with Bored API?

Bored API is a Developer Tools API. Developers commonly use developer tools APIs for:

automating code review and quality checks
integrating CI/CD pipelines and build systems
managing feature flags and A/B tests
monitoring errors and application performance
generating and validating test data

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Bored API is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide

Open documentation ↗