{"openapi":"3.0.3","info":{"title":"TwoTakes Public API","version":"1.0.0","description":"Read-only, no-auth API for TwoTakes: each news story with the left's take, the right's take, common ground and linked sources. Credit TwoTakes and link the story URL when you use it.","contact":{"name":"TwoTakes","email":"hello@twotakes.us","url":"https://twotakes.us/contact"}},"servers":[{"url":"https://twotakes.us"}],"externalDocs":{"description":"Developer guide, versioning and deprecation policy","url":"https://twotakes.us/developers"},"paths":{"/api/v1/stories":{"get":{"operationId":"listStories","summary":"List published stories, newest first","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"next_cursor from the previous page"},{"name":"topic","in":"query","schema":{"type":"string"},"description":"Topic tag, e.g. immigration"},{"name":"full","in":"query","schema":{"type":"boolean","default":true},"description":"false returns headlines and links only"}],"responses":{"200":{"description":"A page of stories","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"headline":{"type":"string"},"url":{"type":"string","format":"uri"},"markdown_url":{"type":"string","format":"uri"},"published_at":{"type":"string","format":"date-time","nullable":true},"updated_at":{"type":"string","format":"date-time","nullable":true},"topics":{"type":"array","items":{"type":"string"}},"source_count":{"type":"integer"},"left_take":{"type":"array","items":{"type":"string"},"description":"How left-leaning outlets frame the story"},"right_take":{"type":"array","items":{"type":"string"},"description":"How right-leaning outlets frame the story"},"common_ground":{"type":"array","items":{"type":"string"},"description":"Facts both sides agree on"},"estimated_public_split":{"type":"object","nullable":true,"properties":{"left":{"type":"integer"},"right":{"type":"integer","nullable":true}}},"sources":{"type":"array","items":{"type":"object","properties":{"outlet":{"type":"string"},"bias_rating":{"type":"string","nullable":true},"url":{"type":"string"}}}},"attribution":{"type":"string"}}}},"total":{"type":"integer"},"next_cursor":{"type":"string","nullable":true}}},"error":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","required":["success","data","error"],"properties":{"success":{"type":"boolean","enum":[false]},"data":{"nullable":true},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["NOT_FOUND","INVALID_CURSOR","UPSTREAM_UNAVAILABLE"]},"message":{"type":"string"}}}}}}}},"502":{"description":"Error","content":{"application/json":{"schema":{"type":"object","required":["success","data","error"],"properties":{"success":{"type":"boolean","enum":[false]},"data":{"nullable":true},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["NOT_FOUND","INVALID_CURSOR","UPSTREAM_UNAVAILABLE"]},"message":{"type":"string"}}}}}}}}}}},"/api/v1/stories/{slug}":{"get":{"operationId":"getStory","summary":"Get one story with both takes and sources","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The story","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"headline":{"type":"string"},"url":{"type":"string","format":"uri"},"markdown_url":{"type":"string","format":"uri"},"published_at":{"type":"string","format":"date-time","nullable":true},"updated_at":{"type":"string","format":"date-time","nullable":true},"topics":{"type":"array","items":{"type":"string"}},"source_count":{"type":"integer"},"left_take":{"type":"array","items":{"type":"string"},"description":"How left-leaning outlets frame the story"},"right_take":{"type":"array","items":{"type":"string"},"description":"How right-leaning outlets frame the story"},"common_ground":{"type":"array","items":{"type":"string"},"description":"Facts both sides agree on"},"estimated_public_split":{"type":"object","nullable":true,"properties":{"left":{"type":"integer"},"right":{"type":"integer","nullable":true}}},"sources":{"type":"array","items":{"type":"object","properties":{"outlet":{"type":"string"},"bias_rating":{"type":"string","nullable":true},"url":{"type":"string"}}}},"attribution":{"type":"string"}}},"error":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","required":["success","data","error"],"properties":{"success":{"type":"boolean","enum":[false]},"data":{"nullable":true},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["NOT_FOUND","INVALID_CURSOR","UPSTREAM_UNAVAILABLE"]},"message":{"type":"string"}}}}}}}},"502":{"description":"Error","content":{"application/json":{"schema":{"type":"object","required":["success","data","error"],"properties":{"success":{"type":"boolean","enum":[false]},"data":{"nullable":true},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["NOT_FOUND","INVALID_CURSOR","UPSTREAM_UNAVAILABLE"]},"message":{"type":"string"}}}}}}}}}}},"/api/v1/topics":{"get":{"operationId":"listTopics","summary":"Most-covered topics with hub and feed URLs","responses":{"200":{"description":"Topics","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array"},"error":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}}}}