{"openapi":"3.1.0","info":{"title":"ClaraFerti Read-Only Agent API","version":"2026-06-24","description":"Read-only fertility education search and fetch surfaces. No diagnosis, treatment, dosing, lab interpretation, emergency guidance, or write actions."},"servers":[{"url":"https://claraferti.com"}],"paths":{"/api/v1/search":{"get":{"summary":"Search ClaraFerti article summaries","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"language","in":"query","schema":{"type":"string"}},{"name":"region","in":"query","schema":{"type":"string"}},{"name":"topic","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Search results"}}}},"/api/v1/articles/{slug}":{"get":{"summary":"Fetch a structured article record","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Article","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"slug":{"type":"string"},"title":{"type":"string"},"canonicalUrl":{"type":"string"},"medicalBoundary":{"type":"string"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}}}}},"/api/v1/evidence/{topic}":{"get":{"summary":"Fetch evidence-oriented article matches for a topic","parameters":[{"name":"topic","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Evidence topic matches"}}}},"/api/v1/agent-policy":{"get":{"summary":"Fetch ClaraFerti agent-use safety policy","responses":{"200":{"description":"Agent policy"}}}},"/llms.txt":{"get":{"summary":"Fetch curated LLM orientation","responses":{"200":{"description":"Markdown text"}}}},"/llms-full.txt":{"get":{"summary":"Fetch full LLM article index","responses":{"200":{"description":"Markdown text"}}}},"/article/{slug}.md":{"get":{"summary":"Fetch clean article markdown","responses":{"200":{"description":"Markdown text"}}}},"/article/{slug}.json":{"get":{"summary":"Fetch clean article JSON","responses":{"200":{"description":"Article JSON"}}}}}}