Documentation

Complete API reference and guides for AgentUtil.

Quick Start

https://api.agentutil.dev

Every tool uses the same async pattern: POST to create a task, GET to poll for the result.

# 1. Create a task

POST /v1/tools/{tool}/tasks

{"email": "user@example.com"}

# Response: 202 Accepted

{"task_id": "task_abc123", "poll_url": "/v1/tasks/task_abc123"}

# 2. Poll for result

GET /v1/tasks/task_abc123

# Response when complete

{"status": "complete", "result": {"deliverable": true, ...}}

Preferred

Just send a request. You'll get a 402 response with payment details. Pay with USDC on Base, then retry with the payment proof.

# 1. Request → 402

POST /v1/tools/email.verify/tasks

← 402 Payment Required

{"x402": {"price": "0.01", "network": "base", "token": "USDC"}}

# 2. Pay + retry

X-Payment-Proof: ...

← 202 Accepted

Alternative

Authorization: Bearer sk_live_...

pending

→

running

→

complete

failed

{
  "task_id": "task_abc123",
  "status": "complete",
  "tool": "email.verify",
  "result": { ... },
  "error": null
}

Status	Meaning	Action
400	Invalid input	Fix request per error message
402	Payment required	Pay via x402 or use API key
404	Not found	Check tool name or task ID
500	Server error	Retry or contact support

/.well-known/agent-service.jsonService metadata

/.well-known/agent.jsonA2A Agent Card

/openapi.jsonOpenAPI 3.1 spec

/v1/toolsList all tools

/v1/tools/{tool}Tool details

Tool	Description	Price
email.verify	Verify email deliverability and quality	$0.01
dns.lookup	Look up DNS records for a domain	$0.005
ip.geolocate	Get geographic location and network info for an IP address	$0.01
geo.locate	Convert an address to geographic coordinates	$0.005
url.status	Check if a URL is reachable and get response details	$0.005
homeservices.search	Find local home service professionals	$0.02
homeservices.request	Submit a service request to a specific professional (from homeservices.search results)	$0.05
browser.screenshot	Capture a screenshot of a webpage or HTML content	$0.01
browser.pdf	Render a webpage or HTML content to PDF	$0.01
browser.content	Get fully rendered HTML content (JavaScript executed)	$0.005
browser.markdown	Extract readable content from a webpage as Markdown	$0.005
browser.scrape	Extract specific elements using named CSS selectors	$0.01
browser.links	Extract all links from a webpage	$0.005