Skip to content

News Trends API

GET/v1/newssignals/trending/people

People with the biggest attention spike against their 30-day baseline: Wikipedia daily pageviews blended with news coverage, classified through Wikidata occupations into celebrity, politics, sport, business or other. Only people with a Wikipedia article and a Wikidata id are ever listed. Refreshes every 60 minutes.

Price

$0.015/ call

Edge cache

1800s

Uptime 24h

100.00%

p95

291ms

MCP tool

newssignals_trending-people

The News Trends API provides signals derived from GDELT's 15-minute global news coding, including tone in basis points, mention volume, novelty, and trending for various entities. The API offers data on trending people and topics ranked by attention spike, as well as the 50 most-covered stories per window. The data is refreshed every 60 minutes and can be accessed through a GET request to the /trending/people endpoint.

Parameters

NameInTypeDescription
category query string celebrity, politics, sport, business, other
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/people"

# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/newssignals/trending/people" -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/people")).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/people").json())
With an API key
curl "https://api.realtimeapi.ai/v1/newssignals/trending/people" -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/people endpoint?

Category, window, and limit

Get a free key

1,000 calls a month across every feed. Who is setting it up?

No key needed at all: agents can pay per call in USDC with x402.