{"openapi":"3.1.0","info":{"title":"Hynx Web","version":"2026.10","description":"Web search and page extraction for agents. Results are ranked, de-duplicated and returned as structured JSON.","x-clankerbay-namespace":"hynx-web","x-clankerbay-schema-version":1,"x-clankerbay-schema-hash":"3b7590729d8876ebe9c53c3df2419f36f74ae653a2c66ba2966e95dd1bdf4cb8"},"servers":[{"url":"https://clankerbay.hxx.li/api/v1/gateway/hynx-web","description":"Clankerbay gateway"}],"paths":{"/search":{"get":{"operationId":"searchWeb","x-cli-command":"search","x-clankerbay-price":2,"summary":"Search the web for pages, recipes, articles and documentation","description":"Keyword or natural-language web search. Returns titles, URLs and snippets ranked by relevance.","parameters":[{"name":"q","in":"query","required":true,"description":"What to search for, e.g. \"cake recipes\"","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"limit","in":"query","description":"Maximum number of results","schema":{"type":"integer","minimum":1,"maximum":20,"default":5}},{"name":"cursor","in":"query","description":"Pagination cursor from next_cursor","schema":{"type":"string"}}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResults"}}}},"400":{"description":"Invalid query"}},"x-clankerbay-command":"search","x-clankerbay-endpoint-id":1}},"/pages/{id}":{"get":{"operationId":"getPage","x-cli-command":"page","x-clankerbay-price":3,"summary":"Fetch the clean text of a search result page","parameters":[{"name":"id","in":"path","required":true,"description":"Page id from a search result","schema":{"type":"string"}}],"responses":{"200":{"description":"Page text","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"404":{"description":"Unknown page"}},"x-clankerbay-command":"page","x-clankerbay-endpoint-id":2}},"/summarize":{"post":{"operationId":"summarizeText","x-cli-command":"summarize","x-clankerbay-price":5,"summary":"Summarize text into a few sentences or bullet points","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","description":"Text to summarize"},"max_sentences":{"type":"integer","minimum":1,"maximum":10,"default":3},"bullets":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"Summary","content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"string"},"sentences":{"type":"integer"}}}}}}},"x-clankerbay-command":"summarize","x-clankerbay-endpoint-id":3}}},"components":{"schemas":{"SearchResults":{"type":"object","properties":{"query":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"snippet":{"type":"string"},"score":{"type":"number"}}}},"next_cursor":{"type":["string","null"]}}},"Page":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"text":{"type":"string"}}}},"securitySchemes":{"clankerbay":{"type":"http","scheme":"bearer","description":"Clankerbay agent token"}}},"security":[{"clankerbay":[]}]}