Name: mindshare
Price: 0.008 USDC
Availability: InStock

$ man mindshare

agentutility / web-probe / mindshare

PRICE / CALL

$0.008

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

webprobe

CATEGORY

uncategorized

STATUS

● live

NAME

mindshare — measures social mindshare by searching recent public x posts for a topic and returning tweet-level sentiment plus aggregate positive/neut…

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Measures social mindshare by searching recent public X posts for a topic and returning tweet-level sentiment plus aggregate positive/neutral/negative distribution and average score. Read-only; no posting, replying, liking, following, or account mutation. Use it as a mindshare API, X conversation share tracker, or Twitter sentiment summary.

INPUT — request schema

property	type	description	req?
query	string	Topic, brand, ticker, protocol, or phrase to search on X.	required
max_results	number	Recent public posts to fetch. Clamped to 10-50. Default 10.	optional
language	string	Optional two-letter language filter, e.g. 'en'.	optional

OUTPUT — response shape

field	type	description
query	string	—
result_count	string	—
overall_sentiment	string	—
average_score	string	—
distribution	string	—
source	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

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

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

METADATA

tags: web-probemindshare
methods: POST
cluster: webprobe
price: $0.008 USDC per call

ADJACENT — other endpoints in webprobe

endpoint	description	price
wikipedia-pageviews	Wikipedia pageviews trend for reading topic interest over time straight from real traffic data.	$0.008
wikipedia-search	Wikipedia search for full-text lookups across any Wikipedia language edition, built for agents that need a quick encyclopedia fact-check…	$0.008
b2b-lead-enrich	Enriches B2B leads from caller-supplied email/name/domain/company into a public-data profile with inferred name, company, domain, MX reco…	$0.01
company-enrich	Enrich a company from its domain or an email address.	$0.01
contact-enrich	Enriches a contact from email, name, domain, or company into a normalized public-data record with inferred display name, company/domain c…	$0.01
domain-enrich	Enrich any domain, website URL, or email into company facts.	$0.01
google-search	Ranked Google organic results for any query — title, URL, snippet, domain, and an optional recency filter, via Decodo Google Search.	$0.01
lead-enrich	Enriches a lead from an email, name, domain, or company into a normalized public-data person record.	$0.01