Name: public-post-search
Price: 0.006 USDC
Availability: InStock

$ man public-post-search

agentutility / web-probe / public-post-search

PRICE / CALL

$0.006

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

webprobe

CATEGORY

uncategorized

STATUS

● live

NAME

public-post-search — searches recent public posts on x/twitter with public metrics and author expansion

synonym alias of x-search — reuses the canonical handler.

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Searches recent public posts on X/Twitter with public metrics and author expansion. Same read-only backend as x-search; useful for agents that ask for public post search rather than tweet search. No account mutation. Use it as a public post search API, social post search API, or X recent search endpoint.

INPUT — request schema

property	type	description	req?
query	string	X recent-search query.	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/public-post-search \
  -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 public-post-search tool from your MCP-aware agent.

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

METADATA

tags: web-probepublicpostsearchpublic-post-search
methods: POST
cluster: webprobe
price: $0.006 USDC per call

ADJACENT — other endpoints in webprobe

endpoint	description	price
google-search	Ranked Google organic results via Decodo Google Search.	$0.006
mentions	Monitors public X mentions of a brand, handle, URL, ticker, or phrase by searching recent posts and returning matches with author and met…	$0.006
recent-tweet-search	Searches recent public tweets/posts on X and returns text, timestamps, public metrics, and expanded author context.	$0.006
search	Returns ranked Decodo Google web results.	$0.006
search-site	Site/domain-scoped search via Decodo Google results.	$0.006
search-web	Answer engine retrieval API for finding live web sources before an agent writes its own response.	$0.006
serp-search	Pull ranked Decodo Google results for any query.	$0.006
site-search	Searches the public web, or a specific site/domain when the query includes a site: filter, via Decodo Google Search.	$0.006