topic_headlines
Retrieve news headlines for a specific topic or publication, with options to limit results and filter by country and language.
Instructions
Get the latest news headlines for a topic (World, Sports, Technology, etc) or publication (e.g. CNN, BBC, etc).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"topic": "<topic>"
},
"name": "topic_headlines"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic | Yes | Topic or publication for which to get news headlines. Available topics: WORLD NATIONAL BUSINESS TECHNOLOGY ENTERTAINMENT SPORTS SCIENCE HEALTH 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) | |
| limit | No | Maximum number of news articles to return. Default: 500 Allowed values: 1-500 | 500 |
| country | No | Country code. See all available country codes. Default: US | |
| lang | No | The language to use for the results, specified as a 2-letter language code - see ISO 639-1 alpha-2. Default: en |