NewsAPI News Get Top Headlines

2 credits/call
ae_news_get_top_headlines

Get live top and breaking News API headlines by country, category, source, or keyword. Choose at least one of these filters.

News
2 credits/call

Pricing

2 credits/call
ConditionCharge
Each call2 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
qstringNoKeywords or a phrase to search for in the article title and body.—
pageintegerNoUse this to page through the results. Default is 1.1
countryenum (ae | ar | at | au | be | bg | br | ca | ch | cn | co | cu | cz | de | eg | fr | gb | gr | hk | hu | id | ie | il | in | it | jp | kr | lt | lv | ma | mx | my | ng | nl | no | nz | ph | pl | pt | ro | rs | ru | sa | se | sg | si | sk | th | tr | tw | ua | us | ve | za)NoThe 2-letter ISO 3166-1 code of the country you want to get headlines for. Note: you cannot mix this with the sources parameter.—
sourcesstringNoA comma-separated string of identifiers for the news sources or blogs you want headlines from. Note: you cannot mix this with the country or category parameters.—
categoryenum (business | entertainment | general | health | science | sports | technology)NoThe category you want to get headlines for. Note: you cannot mix this with the sources parameter.—
pageSizeintegerNoThe number of results to return per page. 20 is the default, 100 is the maximum.20

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_news_get_top_headlines' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "category": "general",
    "country": "us",
    "pageSize": 10
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "articles": [
    {
      "author": "Mike Florio",
      "content": "Eight years to the day after Baker Mayfield made his debut for the Browns, hell be facing the Browns in his fourth year as the starting quarterback of the Buccaneers.\r\nBuccaneers senior offensive ass… [+1535 chars]",
      "description": "Eight years to the day after Baker Mayfield made his debut for the Browns, he'll be facing the Browns in his fourth year as the starting quarterback of the Buccaneers.",
      "publishedAt": "2026-09-16T23:43:22Z",
      "title": "Ken Zampese: Browns \"mucked it up\" with Baker Mayfield - NBC Sports",
      "url": "https://www.nbcsports.com/nfl/profootballtalk/rumor-mill/news/ken-zampese-browns-mucked-it-up-with-baker-mayfield"
    }
  ],
  "status": "ok",
  "totalResults": 35
}

This example shows part of the response. Copied content is valid JSON.