{"openapi":"3.1.0","info":{"title":"BJJ Professor API","version":"1.0.0","description":"Read-only access to the BJJ knowledge graph and position chapters. Every answer carries timestamped clips from named coaches and the page URL to cite. For personal coaching and roll review, use the MCP server: https://bjjprofessor.app/connect"},"servers":[{"url":"https://bjjprofessor.app/api/v1"}],"security":[],"externalDocs":{"description":"Public API guide and examples","url":"https://bjjprofessor.app/developers"},"paths":{"/positions/search":{"get":{"operationId":"searchPositions","summary":"Find positions, techniques and concepts by name or alias","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":8,"maximum":25}}],"responses":{"200":{"description":"Ranked hits","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/positions/{id}":{"get":{"operationId":"getPosition","summary":"Chapter (thesis, options with triggers, failure modes), curated clips, page URL","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Node id from /positions/search, e.g. half-guard-bottom"}],"responses":{"200":{"description":"The position","content":{"application/json":{"schema":{"type":"object","properties":{"clips":{"type":"array","items":{"type":"object","properties":{"video_id":{"type":"string"},"t":{"type":"integer","description":"Seconds into the video"},"channel":{"type":"string"},"title":{"type":"string"},"quote":{"type":"string"},"url":{"type":"string","description":"YouTube deep link at the timestamp"}}}}}}}}},"404":{"description":"Unknown id"}}}},"/positions/{id}/transitions":{"get":{"operationId":"getTransitions","summary":"What leads in and out of a position, with the coach's trigger and a clip per edge","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Node id from /positions/search, e.g. half-guard-bottom"}],"responses":{"200":{"description":"Sections of transitions"},"404":{"description":"Unknown id"}}}},"/chapters":{"get":{"operationId":"listChapters","summary":"Every curated chapter with thesis and URL","responses":{"200":{"description":"Chapters"}}}},"/demo-rolls":{"get":{"operationId":"listDemoRolls","summary":"Example roll reviews of famous matches","responses":{"200":{"description":"Demos"}}}},"/demo-rolls/{id}":{"get":{"operationId":"getDemoRoll","summary":"One example review: coach's read, moments, timeline","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Demo review id returned by /demo-rolls"}],"responses":{"200":{"description":"Review"},"404":{"description":"Unknown id"}}}}}}