> ENDPOINT
GET https://usubjects.com/api/v1/sightings
> PARAMETERS
| PARAM | TYPE | DESCRIPTION |
|---|---|---|
| state | string | US state code, e.g. `ca`, `tx`, `ny` |
| country | string | 2-letter country code, e.g. `us`, `ca`, `gb` |
| shape | string | Reported shape, e.g. `disk`, `triangle`, `light` |
| year | int | Year of the sighting |
| limit | int | Rows per page, 1–200 (default 50) |
| after | int | Keyset cursor — pass the last id, or use `meta.next` |
> EXAMPLE
curl "https://usubjects.com/api/v1/sightings?state=ca&shape=triangle&limit=5"
{
"meta": {
"source": "NUFORC (public witness reports, unverified)",
"license": "Open data — attribution appreciated: usubjects.com",
"count": 5,
"limit": 5,
"next": "/api/v1/sightings?state=ca&shape=triangle&limit=5&after=1234"
},
"data": [
{
"id": 1234,
"occurredAt": "1997-11-15T22:00:00.000Z",
"occurredYear": 1997,
"city": "san diego",
"state": "ca",
"country": "us",
"shape": "triangle",
"durationSeconds": 300,
"durationText": "5 minutes",
"summary": "Three lights in a triangular formation...",
"latitude": 32.7153,
"longitude": -117.1573
}
]
}> PAGINATION
Results are keyset-paginated on `id` for stable, fast paging at any depth. Follow `meta.next` until it is `null`.
> SOURCE & CAVEATS
Data derives from the public NUFORC witness-report database. Reports are self-submitted and unverified — treat them as reports, not confirmed events. Use freely for research, journalism and projects.