API

bored alien opens its entire UAP archive as data — free for developers, researchers, and journalists.

The data is compiled from publicly released, public-domain U.S. government records. Access is free and keyless; every endpoint is read-only JSON with CORS enabled. If you use it, please credit the source and link back to boredalien.com.

Base URL

https://boredalien.com

GET /api/cases

Returns a slim list of all cases (without the full detail body, for smaller payloads). Supports filtering and pagination.

Param	Values	Description
type	military · radar · mass · photo · astronaut · document · crash	Filter by case type
credibility	official · corroborated · reported · explained	Filter by credibility
tranche	PURSUE-1 · PURSUE-2 · PURSUE-3 · pre-disclosure	Filter by disclosure batch
country	US, IQ, SY, GB …	Filter by country code
hasVideo	true · false	Only cases with (or without) video
year	2004	Filter by incident year
q	keyword	Search title / location / summary (zh + en)
limit	default 50, max 500	Page size
offset	default 0	Pagination offset

Example request

GET https://boredalien.com/api/cases?type=military&hasVideo=true&limit=5

Example response

{
  "version": 1,
  "license": "Source records are U.S. government public-domain material. …",
  "count": 5,
  "total": 12,
  "limit": 5,
  "offset": 0,
  "cases": [
    {
      "id": "nimitz-tictac-2004",
      "date": "2004-11-14",
      "dateDisplay": { "zh": "2004 年 11 月 14 日", "en": "November 14, 2004" },
      "title": { "zh": "尼米兹号 Tic-Tac 事件", "en": "The Nimitz 'Tic-Tac' Encounter" },
      "location": {
        "name": { "zh": "美国加州 圣迭戈外海", "en": "Off the coast of San Diego, California, USA" },
        "country": "US", "lat": 32.5, "lng": -118.5
      },
      "type": "military",
      "credibility": "official",
      "tranche": "pre-disclosure",
      "hasVideo": true,
      "summary": { "zh": "…", "en": "…" }
    }
  ]
}

GET /api/cases/{id}

Returns the complete record for one case — including detail, videos, specs, images, and sources. Returns 404 JSON if not found.

Example request

GET https://boredalien.com/api/cases/nimitz-tictac-2004

Example response

{
  "version": 1,
  "license": "…",
  "case": {
    "id": "nimitz-tictac-2004",
    "date": "2004-11-14",
    "title": { "zh": "尼米兹号 Tic-Tac 事件", "en": "The Nimitz 'Tic-Tac' Encounter" },
    "type": "military",
    "credibility": "official",
    "tranche": "pre-disclosure",
    "detail": { "zh": "…", "en": "Background. In November 2004 …" },
    "videos": [
      { "provider": "youtube", "youtubeId": "AFYlcCU7WSQ", "caption": { "zh": "…", "en": "…" } }
    ],
    "specs": [ { "label": { "zh": "目标尺寸", "en": "Object size" }, "value": { "zh": "约 12 米", "en": "~12 m (40 ft)" } } ],
    "sources": [ { "label": "National Archives — UAP records", "url": "https://www.archives.gov/research/topics/uaps" } ]
  }
}

GET /api/stats

Returns dataset summary: totals, video count, year range, and distribution by type / tranche / country.

Example request

GET https://boredalien.com/api/stats

Example response

{
  "version": 1,
  "license": "…",
  "total": 335,
  "withVideo": 111,
  "yearRange": { "from": 1933, "to": 2026 },
  "byType": { "military": 12, "radar": 2, "mass": 10, "photo": 105,
              "astronaut": 34, "document": 168, "crash": 4 },
  "byTranche": { "PURSUE-1": 160, "PURSUE-2": 65, "PURSUE-3": 72, "pre-disclosure": 38 },
  "byCountry": { "US": 117, "SY": 10, "IQ": 8, "...": 0 }
}

License & use

Source records are U.S. government public domain; the organized, rewritten, bilingual presentation is © bored alien. Free to use with attribution and a link back to boredalien.com. For commercial use or higher volume, contact hello@boredalien.com.