# Local Headlines (Geo)

> Local Headlines (Geo) is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Fetch real-time, geo-targeted local news headlines for a specified city, region, or country.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-news-data/local-headlines?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-local-headlines-geo-e52d0784
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6gdIpaNv00v36HxDjvhfY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-local-headlines-geo-e52d0784
```

Example prompt: What are the latest local headlines in Chicago right now? Give me up to 20 articles in English.

## When to prefer this

Choose this endpoint when you need geo-targeted, real-time local news headlines for a specific city, region, or country. It is ideal when the user cares about local relevance rather than global top stories, and when filtering by language and country is important. Prefer this over general news search endpoints when locality is the primary filter rather than topic or keyword.

## Known failure modes

- Empty or vague query returns no results or irrelevant articles
- Invalid country code may fall back to default 'us' or return an error
- Unsupported language code may return results in a fallback language
- Rate limits or payment issues may return 402 or 429 status codes
- Very small or obscure localities may return sparse or no results
- Limit parameter above 500 is capped at maximum of 500

## How this service works

Get local, geo based headlines.

## Output

Returns an array of news articles, each containing a headline title, canonical article URL, optional snippet/excerpt, authors, publication datetime in UTC, source name and URL, thumbnail and photo URLs, source logo/favicon, and related Google News topic tags. Also includes a status string and unique request ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 500,
   "maximum": 500,
   "minimum": 1,
   "description": "Maximum number of news articles to return."
  },
  "query": {
   "type": "string",
   "example": "New York",
   "description": "Area, city or country to fetch news for (e.g. London)."
  },
  "country": {
   "type": "string",
   "default": "us",
   "description": "Country code. See all available country codes."
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "The language to use for the results, specified as a 2-letter language code - see ISO 639-1 alpha-2."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "title",
     "link"
    ],
    "properties": {
     "link": {
      "type": "string",
      "description": "Canonical URL of the article."
     },
     "title": {
      "type": "string",
      "description": "Headline of the news article."
     },
     "authors": {
      "type": "array",
      "items": {
       "type": "string",
       "description": "A single author name."
      },
      "nullable": true,
      "description": "Author names credited on the article."
     },
     "snippet": {
      "type": "string",
      "nullable": true,
      "description": "Short excerpt of the article body."
     },
     "photo_url": {
      "type": "string",
      "nullable": true,
      "description": "URL of the article's lead image."
     },
     "source_url": {
      "type": "string",
      "nullable": true,
      "description": "Homepage URL of the source publisher."
     },
     "source_name": {
      "type": "string",
      "nullable": true,
      "description": "Publisher name of the source."
     },
     "thumbnail_url": {
      "type": "string",
      "nullable": true,
      "description": "URL of the article's thumbnail image."
     },
     "related_topics": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "topic_id",
        "topic_name"
       ],
       "properties": {
        "topic_id": {
         "type": "string",
         "description": "Google News topic ID."
        },
        "topic_name": {
         "type": "string",
         "description": "Topic display name."
        }
       }
      },
      "nullable": true,
      "description": "Related Google News topics surfaced for the article."
     },
     "source_logo_url": {
      "type": "string",
      "nullable": true,
      "description": "URL of the source publisher's logo."
     },
     "source_favicon_url": {
      "type": "string",
      "nullable": true,
      "description": "URL of the source publisher's favicon."
     },
     "source_publication_id": {
      "type": "string",
      "nullable": true,
      "description": "Google News publication ID of the source."
     },
     "published_datetime_utc": {
      "type": "string",
      "nullable": true,
      "description": "ISO 8601 UTC datetime of original publication."
     }
    }
   },
   "description": "Local headline news articles for the requested locale."
  },

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-local-headlines-geo-e52d0784/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)