# SearchPulse

> Grounded web search for AI agents. Question → answer + citations, powered by Bedrock Web Search.

## Endpoints

- GET /v1/search?q={question}&mode=standard — Grounded answer + citations ($0.25, ≤400 tokens)
- GET /v1/search?q={question}&mode=deep    — Deep research answer ($0.25, ≤1200 tokens)
- GET /health                              — Health check (no auth)
- GET /tryit?q={question}                  — Static demo (3/day, no real search)

## Payment

- Protocol: x402 v2
- Standard price: $0.40/query (400000 atomic USDC)
- Deep price:     $0.40/query (400000 atomic USDC)
- Chain 1: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
  - Asset: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC)
  - PayTo: GsKr5q9TmiJQcEgUpBp2X6SmvSg3dnXuw2uxYJxgPTk8
- Chain 2: eip155:8453 (Base mainnet)
  - Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (USDC)
  - PayTo: 0x318A4B4764eb37c3FCBcE434713128143815FD57

## Response Format

{
  "query": "...",
  "mode": "standard",
  "answer": "Grounded answer text with inline citations...",
  "citations": [{ "title": "Source Title", "url": "https://..." }],
  "search_queries": ["query used internally"],
  "tokens_used": { "input": 512, "output": 320 }
}

## Links

- API: https://searchpulse.waltsoft.net
- Full docs: https://searchpulse.waltsoft.net/llms-full.txt