Name: topic-trend-brief
Price: 0.05 USDC
Availability: InStock

$ man topic-trend-brief

agentutility / compose / topic-trend-brief

PRICE / CALL

$0.05

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

compose

CATEGORY

uncategorized

STATUS

● live

NAME

topic-trend-brief — topic trend brief api to check whether interest in a topic is rising: send a topic and window, get back wikipedia pageview trend, recent…

SYNOPSIS

POST https://x402.agentutility.ai/topic-trend-brief
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Topic trend brief API to check whether interest in a topic is rising: send a topic and window, get back Wikipedia pageview trend, recent news mention volume, Hacker News mention volume, and X/Twitter mention volume in one call. Built for agents asking 'is this topic trending' or 'rising topic' without polling four separate signal sources by hand. Composite: one call runs wikipedia-pageviews + news-search + hn-search + x-search in parallel and reports interest over time plus a rising/flat verdict. hn-search is the required leg; wikipedia-pageviews (needs a matching article title), news-search, and x-search (needs an X bearer token configured) degrade the brief instead of failing the call when their upstream can't answer. Use it as a topic trend API, rising-topic detector, or mention-volume tracker for research and market-scouting agents.

INPUT — request schema

property	type	description	req?
topic	string	The topic to check, e.g. 'agentic commerce' or a Wikipedia article title for best pageview matching. Max 300 chars.	required
window	string	Lookback window: '7d', '30d', or '90d'. Default '30d'.	optional

OUTPUT — response shape

field	type	description
topic	string	—
window	string	—
rising	string	—
signals	string	—
pageviews	string	—
news	string	—
hn	string	—
x	string	—
signals_available	string	—
composed_of	string	—
components	string	—
degraded	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/topic-trend-brief \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the topic-trend-brief tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: composetopictrendbrieftopic-trend-brief
methods: POST
cluster: compose
price: $0.05 USDC per call

ADJACENT — other endpoints in compose

endpoint	description	price
claim-corroborate	Fact check a claim and see exactly who agrees and who disagrees.	$0.05
commodity-brief	Market brief for a commodity: recency-scoped web search headlines on price/supply/demand plus a structured research brief with overview,…	$0.05
company-dossier	Builds a company research dossier in one call: firmographic profile, domain intelligence, WHOIS registration, TLS, and tech stack.	$0.05
content-trust-check	Trust screen for a block of text in one call: is it AI-generated, is it safe (content moderation), and is it a near-duplicate of a refere…	$0.05
contract-terms-brief	Pull SLA terms, named entities, PII flags, and a plain-language summary out of a contract or policy document in one call.	$0.05
course-study-kit	Turn a course syllabus into a study kit in one call: a parsed outline, a sequenced reading/study plan, flashcards, and a bullet summary.	$0.05
cross-border-ops-brief	Cross-border operating brief for a country: the FX rate, country profile, visa requirements, upcoming public holidays, and current local…	$0.05
crypto-signal-scan	Structured, informational signal brief for a token or crypto topic: X/Twitter sentiment, recent web coverage, and (when a fiat quote curr…	$0.05