News Trends API
GET/v1/newssignals/trending/topics
Top daily searches (approximate traffic and three headlines each, titles and links only) and trending Mastodon tags and shared links, ranked by attention. Regions US, AU, GB. Refreshes every 60 minutes.
Price
$0.015/ callEdge cache
1800s
Uptime 24h
100.00%
p95
346ms
MCP tool
newssignals_trending-topics
The News Trends API provides signals derived from GDELT's 15-minute global news coding, including tone, mention volume, novelty, and trending data for various entities. The API offers a GET endpoint to retrieve trending topics by region, with parameters for region, window, and limit. The data is refreshed every 60 minutes. The API is priced at $0.015 per request.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| region | query | string = US | |
| window | query | string = 24h | |
| limit | query | integer = 20 |
Code
curl
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/newssignals/trending/topics"
# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/newssignals/trending/topics" -H "PAYMENT-SIGNATURE: $X402_PAYMENT"TypeScript · @x402/fetch
// npm i @x402/fetch @x402/core @x402/evm viem
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = x402Client.fromConfig({ schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(PRIVATE_KEY)) }] });
const pay = wrapFetchWithPayment(fetch, client);
const data = await (await pay("https://api.realtimeapi.ai/v1/newssignals/trending/topics")).json();
console.log(data);Python · x402
# pip install "x402[requests,evm]==2.27.0" eth-account
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import register_exact_evm_client
client = x402ClientSync()
register_exact_evm_client(client, EthAccountSigner(Account.from_key(PRIVATE_KEY)))
session = x402_requests(client)
print(session.get("https://api.realtimeapi.ai/v1/newssignals/trending/topics").json())With an API key
curl "https://api.realtimeapi.ai/v1/newssignals/trending/topics" -H "X-API-Key: $RTAPI_KEY"Frequently asked questions
What is the price of the API?
$0.015 per request
What is the refresh rate of the data?
Every 60 minutes
What parameters are available for the trending topics endpoint?
Region, window, and limit