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.
2 credits/call
Pricing
2 credits/call
| Condition | Charge |
|---|---|
| Each call | 2 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
q | string | No | Keywords or a phrase to search for in the article title and body. | — |
page | integer | No | Use this to page through the results. Default is 1. | 1 |
country | enum (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) | No | The 2-letter ISO 3166-1 code of the country you want to get headlines for. Note: you cannot mix this with the sources parameter. | — |
sources | string | No | A 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. | — |
category | enum (business | entertainment | general | health | science | sports | technology) | No | The category you want to get headlines for. Note: you cannot mix this with the sources parameter. | — |
pageSize | integer | No | The 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-KeyRequest 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
{
"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.







