agentutility(7)$ man serp-search
/serp-search
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobeCATEGORY
uncategorized
STATUS
● live
NAME
serp-search — pull ranked google search results, title, url, snippet, and domain, for any query
SYNOPSIS
POST https://x402.agentutility.ai/serp-search
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Pull ranked Google search results, title, URL, snippet, and domain, for any query. Backed by Decodo Google Search, this SERP API is built for routers and agents that need source discovery and link retrieval without LLM synthesis or a summarized answer. Send a query and a result count, get back a ranked results list with domain metadata for citation, comparison research, or competitive tracking. Use it as a Google search API, SERP scraper alternative, or web search results feed.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| query | string | Search query. 1-500 chars. | required |
| num_results | number | Number of results to return. Default 10, max 20. | optional |
| include_text | boolean | Whether to include fetched page text when available. | optional |
| recency | string | Optional freshness filter. Default 'any'. enum: day · week · month · year · any | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| query | string | — |
| results | string | — |
| source | string | — |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/serp-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 serp-search tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- web-probeserpsearchserp-search
- methods
- POST
- cluster
- webprobe
- price
- $0.01 USDC per call
ADJACENT — other endpoints in webprobe
| endpoint | description | price |
|---|---|---|
| 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 |
| lead-enrich | Enriches a lead from an email, name, domain, or company into a normalized public-data person record. | $0.01 |
| ncbi-taxonomy-lookup | Taxonomy lookup for resolving a common or scientific organism name into its NCBI TaxID, rank, and full ancestor lineage. | $0.01 |
| people | Looks up a person from an email, name, domain, or company and returns a normalized public-data record (alias of people-enrich). | $0.01 |
| people-enrich | Enriches a person record from an email, name, domain, or company using public data only. | $0.01 |
SEE ALSO