{"id":"web-search","title":"Web search: licensed Exa/Brave results with snippets","description":"Runs a web search through a licensed search API (Exa or Brave) and returns up to 10 ranked results with title, URL, snippet, highlights and published date, for agents that need current links. Does not scrape search engines, does not fetch or summarize the result pages (use page-contents for that), and does not use a model.","roi":"Current web results from a licensed index in one call, without a search-API account or key.","audience":"developer","channels":["x402","mcp","rapidapi","apify"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/web-search","path":"/api/v1/web-search","contentType":"application/json"},"price":{"amount":"0.01","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["query"],"properties":{"query":{"type":"string","minLength":1,"maxLength":400,"description":"Search query."},"num_results":{"type":"integer","minimum":1,"maximum":10,"default":5},"provider":{"type":"string","enum":["auto","exa","brave"],"default":"auto","description":"auto uses Exa when configured, else Brave."},"include_text":{"type":"boolean","default":false,"description":"Ask the provider for highlights/extra snippet text per result."},"site":{"type":"string","maxLength":253,"description":"Restrict to a domain, for example example.com."},"date_from":{"type":"string","maxLength":10,"description":"Only results published on or after this date, YYYY-MM-DD."}}},"resultSchema":{"type":"object","properties":{"provider":{"type":"string","enum":["exa","brave"]},"query":{"type":"string"},"query_sha256":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"},"snippet":{"type":"string","description":"May be empty."},"highlights":{"type":"array","items":{"type":"string"}},"published_date":{"anyOf":[{"type":"string","description":"Provider value, or null."},{"type":"null"}]},"snippet_sha256":{"type":"string","description":"sha256 of snippet and highlights joined by newlines."}}}},"result_count":{"type":"integer"},"fetched_at":{"type":"string"},"limits":{"type":"object","properties":{"note":{"type":"string"}}}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"provider":{"type":"string","enum":["exa","brave"]},"query":{"type":"string"},"query_sha256":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"},"snippet":{"type":"string","description":"May be empty."},"highlights":{"type":"array","items":{"type":"string"}},"published_date":{"anyOf":[{"type":"string","description":"Provider value, or null."},{"type":"null"}]},"snippet_sha256":{"type":"string","description":"sha256 of snippet and highlights joined by newlines."}}}},"result_count":{"type":"integer"},"fetched_at":{"type":"string"},"limits":{"type":"object","properties":{"note":{"type":"string"}}}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"query":"x402 payment protocol HTTP 402","num_results":5,"include_text":true},"openapiOperation":{"operationId":"web_search","summary":"Web search: licensed Exa/Brave results with snippets","description":"Runs a web search through a licensed search API (Exa or Brave) and returns up to 10 ranked results with title, URL, snippet, highlights and published date, for agents that need current links. Does not scrape search engines, does not fetch or summarize the result pages (use page-contents for that), and does not use a model.\n\nPrice: 0.01 USDC on Base (x402).","x-x402-price-usdc":"0.01","x-x402-amount":"10000","x-audience":"developer","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/web-search","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["query"],"properties":{"query":{"type":"string","minLength":1,"maxLength":400,"description":"Search query."},"num_results":{"type":"integer","minimum":1,"maximum":10,"default":5},"provider":{"type":"string","enum":["auto","exa","brave"],"default":"auto","description":"auto uses Exa when configured, else Brave."},"include_text":{"type":"boolean","default":false,"description":"Ask the provider for highlights/extra snippet text per result."},"site":{"type":"string","maxLength":253,"description":"Restrict to a domain, for example example.com."},"date_from":{"type":"string","maxLength":10,"description":"Only results published on or after this date, YYYY-MM-DD."}}},"example":{"query":"x402 payment protocol HTTP 402","num_results":5,"include_text":true}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"provider":{"type":"string","enum":["exa","brave"]},"query":{"type":"string"},"query_sha256":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"},"snippet":{"type":"string","description":"May be empty."},"highlights":{"type":"array","items":{"type":"string"}},"published_date":{"anyOf":[{"type":"string","description":"Provider value, or null."},{"type":"null"}]},"snippet_sha256":{"type":"string","description":"sha256 of snippet and highlights joined by newlines."}}}},"result_count":{"type":"integer"},"fetched_at":{"type":"string"},"limits":{"type":"object","properties":{"note":{"type":"string"}}}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://writerslogic.com/agents/web-search/","docsJson":"https://writerslogic.com/agents/web-search.json","sample":"https://agents.writerslogic.com/api/v1/samples/web-search","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://writerslogic.com/agents/index.json"}}