{"openapi": "3.1.0", "info": {"title": "AgentSearch Free Relay", "version": "0.3.0", "description": "Free public relay at https://relay.agentsearchhq.com. 25 free web searches per IP, 10 free news / search_and_read / screenshot calls per IP each (lifetime), plus extract (5/day) and render (3/day) trials. After the free allowance the relay returns HTTP 402 (or 429 for AgentSearch-tagged clients) with paid x402 instructions. Hosted MCP: https://relay.agentsearchhq.com/mcp.", "contact": {"url": "https://agentsearchhq.com"}}, "servers": [{"url": "https://relay.agentsearchhq.com"}], "paths": {"/healthz": {"get": {"summary": "Health", "responses": {"200": {"description": "OK"}}}}, "/v1/health": {"get": {"summary": "Health", "responses": {"200": {"description": "OK"}}}}, "/v1/version": {"get": {"summary": "Version", "responses": {"200": {"description": "OK"}}}}, "/v1/search": {"post": {"summary": "Web search", "description": "25 free searches per IP, then pay per call ($0.003).", "operationId": "web_search", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["query"], "properties": {"query": {"type": "string", "minLength": 2}, "max_results": {"type": "integer", "minimum": 1, "maximum": 5}}}, "example": {"query": "x402 payment protocol", "max_results": 5}}}}, "responses": {"200": {"description": "Success. Includes free_allowance when served by the free relay."}, "400": {"description": "Invalid input."}, "402": {"description": "Free allowance used; x402 payment required (AgentSearch-tagged clients receive 429)."}, "429": {"description": "Free allowance used (AgentSearch packages) or a daily trial cap."}}}}, "/v1/news": {"post": {"summary": "News search", "description": "Recent news for a topic, company or event.", "operationId": "news_search", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["query"], "properties": {"query": {"type": "string", "minLength": 2, "maxLength": 400, "description": "News topic, company, person or event."}, "max_results": {"type": "integer", "minimum": 1, "maximum": 10, "description": "How many articles (default 5)."}}}, "example": {"query": "Federal Reserve interest rate", "max_results": 5}}}}, "responses": {"200": {"description": "Success. Includes free_allowance when served by the free relay."}, "400": {"description": "Invalid input."}, "402": {"description": "Free allowance used; x402 payment required (AgentSearch-tagged clients receive 429)."}, "429": {"description": "Free allowance used (AgentSearch packages) or a daily trial cap."}}}}, "/v1/search_and_read": {"post": {"summary": "Search and read", "description": "10 free search-and-read calls per IP, then $0.005.", "operationId": "search_and_read", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["query"], "properties": {"query": {"type": "string", "minLength": 2}, "num_results": {"type": "integer", "minimum": 1, "maximum": 5}, "max_chars": {"type": "integer", "minimum": 1, "maximum": 20000}, "render_fallback": {"type": "boolean"}}}, "example": {"query": "x402 payment protocol", "num_results": 2}}}}, "responses": {"200": {"description": "Success. Includes free_allowance when served by the free relay."}, "400": {"description": "Invalid input."}, "402": {"description": "Free allowance used; x402 payment required (AgentSearch-tagged clients receive 429)."}, "429": {"description": "Free allowance used (AgentSearch packages) or a daily trial cap."}}}}, "/v1/screenshot": {"post": {"summary": "Website screenshot", "description": "PNG or JPEG screenshot of a public URL.", "operationId": "website_screenshot", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["url"], "properties": {"url": {"type": "string", "format": "uri", "description": "Absolute public http(s) URL."}, "format": {"type": "string", "enum": ["png", "jpeg"], "description": "Image format (default png)."}, "full_page": {"type": "boolean", "description": "Capture the whole page (clipped at 4000 px)."}, "viewport": {"type": "object", "properties": {"width": {"type": "integer", "minimum": 320, "maximum": 1920}, "height": {"type": "integer", "minimum": 240, "maximum": 1600}}}}}, "example": {"url": "https://example.com", "format": "png"}}}}, "responses": {"200": {"description": "Success. Includes free_allowance when served by the free relay."}, "400": {"description": "Invalid input."}, "402": {"description": "Free allowance used; x402 payment required (AgentSearch-tagged clients receive 429)."}, "429": {"description": "Free allowance used (AgentSearch packages) or a daily trial cap."}}}}, "/v1/extract": {"post": {"summary": "Extract", "description": "5 extract calls/day per IP trial, then $0.002.", "operationId": "extract", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["url"], "properties": {"url": {"type": "string", "format": "uri"}, "max_chars": {"type": "integer"}, "include_links": {"type": "boolean"}}}, "example": {"url": "https://example.com"}}}}, "responses": {"200": {"description": "Success. Includes free_allowance when served by the free relay."}, "400": {"description": "Invalid input."}, "402": {"description": "Free allowance used; x402 payment required (AgentSearch-tagged clients receive 429)."}, "429": {"description": "Free allowance used (AgentSearch packages) or a daily trial cap."}}}}, "/v1/render": {"post": {"summary": "Render", "description": "3 render calls/day per IP trial (text only), then $0.005.", "operationId": "render", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["url"], "properties": {"url": {"type": "string", "format": "uri"}, "formats": {"type": "array", "items": {"type": "string"}}, "max_chars": {"type": "integer"}}}, "example": {"url": "https://example.com"}}}}, "responses": {"200": {"description": "Success. Includes free_allowance when served by the free relay."}, "400": {"description": "Invalid input."}, "402": {"description": "Free allowance used; x402 payment required (AgentSearch-tagged clients receive 429)."}, "429": {"description": "Free allowance used (AgentSearch packages) or a daily trial cap."}}}}}}