Google Serper News
1 credits/call
ae_serper_news
Find recent news articles and headlines from Google News. Track current events, breaking news, and media coverage for specific topics or brands.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
q | string | Yes | Search query. The request body field name must be q (not query). | — |
gl | string | No | Country code / geographic market, e.g. us. | — |
hl | string | No | Language code, e.g. en. | — |
num | integer | No | Number of results requested. | — |
tbs | string | No | Google time/search filter string, e.g. qdr:w. | — |
page | integer | No | Page number, when supported. | — |
location | string | No | Human-readable location bias, when supported. | — |
autocorrect | boolean | No | Whether query autocorrect should be enabled. | — |
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_serper_news' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"gl": "cn",
"hl": "zh",
"num": 20,
"q": "癫痫",
"tbs": "qdr:d"
}
}'Response exampleresponse.json
{
"credits": 1,
"news": [
{
"date": "3 hours ago",
"imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2UwC5Nr7zx1oWgKsWOUvGgmI1a2hsU-r4rS6C8cou-WeX12W8Yi3tAzUyT74b55jbWlhm1ZCYgJUWYrMgDXdiLqEBrBPqtRiMH-vD0ntFEsRW&s",
"link": "https://cn.investing.com/news/transcripts/article-93CH-3662966",
"snippet": "Xenon制药(XENE)于2026年11月11日(周三)出席Stifel 2026年医疗健康大会,就其核心资产azetukalner在癫痫领域的广泛布局、向精神科领域拓展的可能性以及不断壮大的...",
"source": "英为财情 Investing.com",
"title": "Xenon制药出席Stifel 2026年医疗健康大会:癫痫药物上市计划备受关注 提供者 Investing.com"
}
],
"searchParameters": {
"allowSuggested": true,
"engine": "google",
"gl": "cn",
"num": 10,
"page": 1,
"type": "news"
}
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows


