# Topic News By Section

> Topic News By Section 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).

Fetches news articles from a specific section (e.g. Sports, Technology) within a given topic or publication (e.g. CNN, BBC) in real time.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-news-data/topic-news-by-section?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-topic-news-by-section-f395ed8a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vyKVfF4pHpm3ZC_O6pk44

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-topic-news-by-section-f395ed8a
```

Example prompt: Pull me up to 50 of the latest Technology news articles from the Sports section for the US in English — I want headlines, snippets, and source names.

## When to prefer this

Use this endpoint when you need real-time news articles scoped to a specific section within a topic (e.g. the 'Football' sub-section of Sports) or a specific publication (CNN, BBC), rather than broad top headlines. It is ideal when you need structured article metadata including authors, snippets, images, and related topics, and you want to filter by country and language. Prefer this over general headline endpoints when section-level granularity is required.

## Known failure modes

- Invalid or unsupported topic enum value returns an error
- Unrecognized country code may return empty results or an error
- Unsupported language code may fall back to default or return an error
- Section not found for the given topic returns empty data array
- Rate limiting or quota exhaustion returns a payment/authorization error
- Network timeout if upstream Google News data is slow to respond

## How this service works

Get news article in a specific section of a topic (World,  Sports, Technology, etc) or publication (CNN, BBC, etc).

## Output

Returns an array of news articles each containing headline, canonical URL, short snippet, author names, publication datetime (UTC), source name and URL, thumbnail and photo URLs, source logo/favicon URLs, Google News publication ID, and related topic tags. Also includes a request status string and unique request ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "topic"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 500,
   "maximum": 500,
   "minimum": 1,
   "description": "Maximum number of news articles to return."
  },
  "topic": {
   "enum": [
    "WORLD",
    "NATIONAL",
    "BUSINESS",
    "TECHNOLOGY",
    "ENTERTAINMENT",
    "SPORTS",
    "SCIENCE",
    "HEALTH"
   ],
   "type": "string",
   "example": "WORLD",
   "description": "Topic or publication for which to get news headlines.  \n  In addition, topic / publication IDs are also accepted and can be taken from a News topic URL as it appears after the topics/ or publications/ path part (e.g. Football Topic - /topics/CAAqJQgKIh9DQkFTRVFvSUwyMHZNREoyZURRU0JXVnVMVWRDS0FBUAE)."
  },
  "country": {
   "type": "string",
   "default": "us",
   "description": "Country code. See all available country codes."
  },
  "section": {
   "type": "string"
  },
  "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": "News article results for the requested topic section."
  },
 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-topic-news-by-section-f395ed8a/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)
