# 15Dkatz/official_joke_api

Official Joke API!

Repository: https://github.com/15Dkatz/official_joke_api
Canonical: https://ross.abutalabs.com/products/official_joke_api
Homepage: https://davidtkatz.com
Language: JavaScript
License: MIT
License Family: permissive
Last push: 2024-12-06T06:22:10+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3449, "days_push": 635, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1022, forks 390 (observed 2026-08-28T04:03:16.109755+00:00)

## What it is
A free REST API serving random jokes in JSON format, with endpoints for random jokes, jokes by type (e.g., programming), jokes by ID, and bulk retrieval. It is hosted on App Engine and can also be self-hosted via Node.js.

## Use cases
- get random jokes as json for my app
- fetch programming jokes via an api
- free joke api with no api key
- serve jokes on my website
- get a batch of ten random jokes
- self-host a joke rest api

## When to choose
- you need a simple, key-free JSON joke API for demos, side projects, or learning HTTP clients
- you want to self-host a lightweight Node.js joke service

## When to avoid
- you need curated, high-quality, or categorized humor content at scale
- you need guaranteed uptime or SLAs, since it is a small community-maintained project

## Facets
- artifact type: service
- maturity: maintenance
- function: http-server, api-framework, json
- domain: apis, entertainment, web-development
- platform: self-hosted
- tags: jokes, rest-api, fun, public-api, json-api, nodejs, web-server

## Member repositories
- 15Dkatz/official_joke_api (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:16.109755+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:08:41.015075+00:00, confidence not recorded.
  - readme: https://github.com/15Dkatz/official_joke_api (fetched 2026-08-28T04:03:16.109755+00:00, sha 5f5bb213efd1)
  - homepage: https://davidtkatz.com (fetched 2026-08-29T13:08:56.002349+00:00, sha b423aa696d97)
- Data as of 2026-08-30T08:39:29.467469+00:00.