{"openapi":"3.1.0","info":{"title":"Counselor Brief content API","version":"1.0.0","description":"Read-only access to the posts published on Counselor Brief. Every HTML page is also available as Markdown via Accept: text/markdown or a .md suffix. No authentication. /api/v1/ is stable; a breaking change ships as /api/v2/ and v1 keeps serving for at least 90 days with Deprecation and Sunset headers. See https://counselorbrief.com/llms.txt."},"servers":[{"url":"https://counselorbrief.com"}],"paths":{"/api/v1/posts/":{"get":{"operationId":"listPosts","summary":"List posts, newest first","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"category","in":"query","schema":{"type":"string"},"description":"Category slug"},{"name":"tag","in":"query","schema":{"type":"string"},"description":"Tag slug"}],"responses":{"200":{"description":"A page of posts","content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PostSummary"}}},"required":["site","total","items"]}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/posts/{slug}/":{"get":{"operationId":"getPost","summary":"One post with its full body as Markdown","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The post","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/PostSummary"},{"type":"object","properties":{"body_markdown":{"type":"string"}},"required":["body_markdown"]}]}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/search/":{"get":{"operationId":"searchPosts","summary":"Search posts by title, summary and topic","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Matching posts, best first","content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PostSummary"}}},"required":["site","total","items"]}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/authors/":{"get":{"operationId":"listAuthors","summary":"Authors with at least one post","responses":{"200":{"description":"Authors","content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"total":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"posts":{"type":"integer"},"bio":{"type":["string","null"]},"url":{"type":"string","format":"uri"}}}}},"required":["site","total","items"]}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"PostSummary":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"excerpt":{"type":["string","null"]},"published":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"},"author":{"type":["object","null"],"properties":{"name":{"type":"string"},"slug":{"type":"string"}}},"categories":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}},"required":["slug","name"]}},"tags":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}},"required":["slug","name"]}},"words":{"type":"integer"},"url":{"type":"string","format":"uri"},"markdown":{"type":"string","format":"uri","description":"The same post as text/markdown"}},"required":["slug","title","published","url","markdown"]},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}