---
title: "Search regional OSINT events"
description: "Searches OSINT events across RSS, USGS, GDACS, ACLED, direct News Terminal items, other threat feeds, and Y2 report extractions. Filters by region, country code, bounding box, radius, source, category, severity, time window, or title text. Text search falls back to description substrings. All filters compose with AND, including coordinate and region filters. Events without coordinates remain unless `requireCoordinates=true` or a bounding-box or radius filter is supplied. Accepts a bearer API key or [x402 payment](https://y2.dev/docs/api/x402). Without a key, read the `402` challenge in `PAYMENT-REQUIRED`. Retry with `PAYMENT-SIGNATURE`."
canonical: https://y2.dev/docs/api/reference/osint/listOsintRegionalEvents/
---

Endpoint Reference[OSINT](https://y2.dev/docs/api/reference/osint)

# Search regional OSINT events

Searches OSINT events across RSS, USGS, GDACS, ACLED, direct News Terminal items, other threat feeds, and Y2 report extractions. Filters by region, country code, bounding box, radius, source, category, severity, time window, or title text. Text search falls back to description substrings. All filters compose with AND, including coordinate and region filters. Events without coordinates remain unless \`requireCoordinates=true\` or a bounding-box or radius filter is supplied. Accepts a bearer API key or \[x402 payment]\(https\://y2.dev/docs/api/x402). Without a key, read the \`402\` challenge in \`PAYMENT-REQUIRED\`. Retry with \`PAYMENT-SIGNATURE\`.

`GET https://api.y2.dev/api/v1/osint/regional`

- Operation ID: `listOsintRegionalEvents`
- Required scopes: `osint:read`
- Accepts x402 pay-per-request payment
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `q` | query | string | No | Full-text search on title (also substring-matches description) |
| `region` | query | `OsintRegionEnum` | No | Filter by geographic region |
| `countryCode` | query | string | No | Filter by ISO 3166-1 alpha-2 country code |
| `sourceType` | query | `usgs`, `rss`, `acled`, `gdelt`, `gdacs`, `eonet`, `firms`, `opensky`, `wingbits`, `adsblol`, `usni`, `polymarket`, `kalshi`, `urlhaus`, `feodo`, `y2_report`, `manual`, `fred`, `yfinance`, `eia`, `nvd`, `cisa_kev`, `cve_list`, `osv`, `intel_expansion`, `intel_discovery`, `news_terminal` | No | Filter by one data source. Omit to include all |
| `category` | query | `OsintEventCategoryEnum` | No | Filter by event category |
| `severity` | query | `OsintSeverityEnum` | No | Filter by severity level |
| `bbox` | query | string | No | WGS 84 bounding box as `west,south,east,north` (longitude/latitude order). Exactly four values are required and antimeridian-crossing boxes are not accepted. |
| `nearLat` | query | number | No | Center latitude for radius filter (requires nearLon + radiusKm) |
| `nearLon` | query | number | No | Center longitude for radius filter (requires nearLat + radiusKm) |
| `radiusKm` | query | number | No | Search radius in kilometers (requires nearLat + nearLon) |
| `requireCoordinates` | query | boolean | No | When true, returns only rows with latitude and longitude |
| `since` | query | integer | No | Inclusive lower bound on eventTime (epoch milliseconds) |
| `until` | query | integer | No | Inclusive upper bound on eventTime (epoch milliseconds) |
| `datetime` | query | string | No | OGC-style RFC 3339 instant or inclusive `start/end` interval. Use `..` for an open boundary. Cannot be combined with legacy `since` or `until`. |
| `limit` | query | integer | No | Maximum number of events to return |
| `temporality` | query | `EventTemporality` | No | `current` (default) returns events that have occurred or are under way, newest first; event times more than 15 minutes after the request are excluded. `forecast` returns scheduled, forecast, and speculative events dated after that point, soonest first. |
| `cursor` | query | string | No | Opaque continuation token from the previous response. Bound to the original filters and ordering. |
| `format` | query | `json`, `ndjson`, `geojson` | No | Select the JSON resource envelope, row-oriented NDJSON, or an RFC 7946 FeatureCollection. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | List of regional events across all sources | `OsintEventListResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 403 | Insufficient permissions or access denied |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[]` | array of `OsintEvent` |  |
| `data[].observedAt` | string or null (date-time) | When Y2 retrieved or last refreshed this observation, independent of event time. |
| `data[].temporality` | `EventTemporality` | Whether the event time is at or before the request time (plus 15 minutes of clock skew) — `current` — or after it — `forecast`. |
| `data[].confidence` | number or null | Extraction confidence for report-derived rows; null for directly ingested rows. |
| `data[].provenanceTier` | `primary`, `derived`, `synthesized`, `null` |  |
| `data[].source` | `RecordSource` | Where a record came from, how Y2 obtained it, and when. |
| `data[].id` | string | Event ID |
| `data[].sourceType` | string | Data source type |
| `data[].sourceId` | string | Source-specific event identifier |
| `data[].title` | string | Event title/headline |
| `data[].description` | string | Detailed event description |
| `data[].category` | `OsintEventCategoryEnum` | OSINT event category classification |
| `data[].severity` | `OsintSeverityEnum` | Event severity level |
| `data[].coordinates` | object or null | Geographic coordinates (null if unavailable) |
| `data[].locationName` | string | Human-readable location name |
| `data[].region` | `OsintRegionEnum` | Geographic region identifier |
| `data[].countryCode` | string | ISO alpha-2 country code |
| `data[].eventTime` | integer (int64) | Event time as Unix timestamp (milliseconds) |
| `data[].eventTimeISO` | string (date-time) | Event time as ISO 8601 string |
| `data[].fetchedAt` | integer or null (int64) | Data fetch time as Unix timestamp (milliseconds), null if unavailable |
| `data[].fetchedAtISO` | string or null (date-time) | Data fetch time as ISO 8601 string, null if unavailable |
| `data[].url` | string (uri) | Source URL for the event |
| `data[].provenance` | `Y2EventProvenance` or null | Extraction provenance metadata. Populated only when `sourceType === "y2_report"`. Null for all other sources. Returned by `/osint/regional`. |
| `meta` | object |  |
| `meta.page` | `PublicPageMeta` |  |
| `meta.count` | integer |  |
| `meta.limit` | integer |  |
| `meta.hasMore` | boolean | Whether more results are available beyond the current limit |
| `meta.filters` | object |  |
