Name: mentions
Price: 0.006 USDC
Availability: InStock

$ man mentions

agentutility / web-probe / mentions

PRICE / CALL

$0.006

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

webprobe

CATEGORY

uncategorized

STATUS

● live

NAME

mentions — monitors public x mentions of a brand, handle, url, ticker, or phrase by searching recent posts and returning matches with author and met…

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Monitors public X mentions of a brand, handle, URL, ticker, or phrase by searching recent posts and returning matches with author and metric fields. Uses X API v2 recent search. Read-only; no posting, replying, liking, following, or account mutation. Use it as a mentions API, X mentions search, Twitter mention monitor, or public social mention search.

INPUT — request schema

property	type	description	req?
query	string	Mention query, e.g. '@bankrbot', 'agentutility.ai', or 'x402 payments'.	required
max_results	number	Number of recent posts to fetch. Clamped to 10-50. Default 10.	optional
language	string	Optional two-letter language filter.	optional

OUTPUT — response shape

field	type	description
mode	string	—
result_count	string	—
source	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/mentions \
  -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 mentions tool from your MCP-aware agent.

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

METADATA

tags: web-probementions
methods: POST
cluster: webprobe
price: $0.006 USDC per call

ADJACENT — other endpoints in webprobe

endpoint	description	price
web-search	Ranked Google results for a query: title, URL, snippet, domain, and a recency filter, via Decodo Google Search.	$0.006
arxiv-bibtex	Turns an arXiv paper into a BibTeX entry: pulls title, authors, year, abstract, and DOI from the arXiv API and generates a properly-forma…	$0.005
brand-name-score	Scores a candidate brand or startup name on quality and risk.	$0.005
company-name-score	Scores the quality of a company name before you commit to domain, handle, trademark, and launch work.	$0.005
crypto-headlines	Searches recent bitcoin, ethereum, and DeFi headlines via GDELT with a GNews fallback when configured, returning headline URLs, domains,…	$0.005
crypto-news	Fetches recent cryptocurrency news headlines from GDELT with a GNews fallback when configured, filtered by crypto topic or caller query,…	$0.005
disposable-email-check	Detects disposable and throwaway email addresses before they get through your signup form.	$0.005
domain-availability	Checks whether a domain is registered and returns registrar, registration date, expiry date, days_until_expiry, and current EPP status flags.	$0.005