---
title: "Country-specific news"
description: "Returns recent country news from the OSINT event pipeline. Uses the observation's indexed ISO country attribution, not countries merely mentioned or exposed to a regional event. Includes unexpired RSS, GDELT, ACLED, News Terminal, and Y2 report observations, excluding seismic and weather categories. Filters apply before pagination. Satellite detections do not consume the news result window. Results retain canonical observation IDs. 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/getCountryNews/
---

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

# Country-specific news

Returns recent country news from the OSINT event pipeline. Uses the observation's indexed ISO country attribution, not countries merely mentioned or exposed to a regional event. Includes unexpired RSS, GDELT, ACLED, News Terminal, and Y2 report observations, excluding seismic and weather categories. Filters apply before pagination. Satellite detections do not consume the news result window. Results retain canonical observation IDs. 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/countries/{countryCode}/news`

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

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `countryCode` | path | string | Yes | ISO 3166-1 alpha-2 country code |
| `limit` | query | integer | No | Maximum number of news items to return |
| `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 | Country-specific news items | `CountryNewsListResponse` |
| 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 `CountryNewsItem` |  |
| `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 | News item ID |
| `data[].title` | string | News headline |
| `data[].description` | string | News description/summary |
| `data[].severity` | `OsintSeverityEnum` | Event severity level |
| `data[].category` | `OsintEventCategoryEnum` | OSINT event category classification |
| `data[].eventTime` | integer (int64) | Event time as Unix timestamp (milliseconds) |
| `data[].eventTimeISO` | string (date-time) |  |
| `data[].occurredAt` | string (date-time) |  |
| `data[].observedAt` | string or null (date-time) |  |
| `data[].fetchedAt` | integer or null (int64) |  |
| `data[].fetchedAtISO` | string or null (date-time) |  |
| `data[].url` | string (uri) | Source URL |
| `data[].sourceType` | string | Data source type |
| `data[].countryCode` | string | Canonical ISO 3166-1 alpha-2 country code used by the indexed query. |
| `data[].region` | string or null | Normalized OSINT region, when known. |
| `data[].locationName` | string or null | Most specific resolved sovereign location, when known. |
| `data[].coordinates` | object or null |  |
| `data[].geometry` | `GeoJSONPoint` | WGS 84 point with longitude first, then latitude. |
| `data[].provenance` | object |  |
| `meta` | object |  |
| `meta.countryCode` | string |  |
| `meta.count` | integer |  |
| `meta.limit` | integer |  |
| `meta.hasMore` | boolean | Whether more results are available beyond the current limit |
