{"openapi":"3.1.0","info":{"title":"TechTools News API","version":"1.0.0","description":"Free, keyless news API for AI agents: AI, tech, business and science news in English and Czech with sources. JSON, Markdown and RSS. 120 requests per minute per IP.","contact":{"name":"TechTools","url":"https://get.techtools.cz/"}},"externalDocs":{"url":"https://techtools.cz/tools/news/api/","description":"Guide with examples"},"servers":[{"url":"https://techtools.cz/news-api/v1"}],"paths":{"/articles":{"get":{"operationId":"listArticles","summary":"List and search articles","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["en","cs","cz"],"default":"en"},"description":"Language of the article set (cz is an alias of cs)."},{"name":"category","in":"query","schema":{"type":"string"},"example":"ai,science","description":"Comma-separated: ai, technology, business, science, other."},{"name":"q","in":"query","schema":{"type":"string"},"description":"Search title, summary and body."},{"name":"since","in":"query","schema":{"type":"string"},"description":"ISO 8601 or age (24h, 7d)."},{"name":"until","in":"query","schema":{"type":"string"},"description":"ISO 8601 or age."},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"content","in":"query","schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"A page of articles","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleList"}}}},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/articles/{id}":{"get":{"operationId":"getArticle","summary":"One article","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["en","cs","cz"],"default":"en"},"description":"Language of the article set (cz is an alias of cs)."}],"responses":{"200":{"description":"The article","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Article"}}}}}},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/articles/{id}.md":{"get":{"operationId":"getArticleMarkdown","summary":"One article as Markdown","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["en","cs","cz"],"default":"en"},"description":"Language of the article set (cz is an alias of cs)."}],"responses":{"200":{"description":"Markdown","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"$ref":"#/components/responses/Error"}}}},"/briefing":{"get":{"operationId":"getBriefing","summary":"Last N hours grouped by category","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["en","cs","cz"],"default":"en"},"description":"Language of the article set (cz is an alias of cs)."},{"name":"category","in":"query","schema":{"type":"string"},"example":"ai,science","description":"Comma-separated: ai, technology, business, science, other."},{"name":"hours","in":"query","schema":{"type":"integer","minimum":1,"maximum":168,"default":24}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":30}}],"responses":{"200":{"description":"Briefing","content":{"application/json":{"schema":{"type":"object"}}}},"422":{"$ref":"#/components/responses/Error"}}}},"/briefing.md":{"get":{"operationId":"getBriefingMarkdown","summary":"Briefing as Markdown for an LLM context","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["en","cs","cz"],"default":"en"},"description":"Language of the article set (cz is an alias of cs)."},{"name":"category","in":"query","schema":{"type":"string"},"example":"ai,science","description":"Comma-separated: ai, technology, business, science, other."},{"name":"hours","in":"query","schema":{"type":"integer","minimum":1,"maximum":168,"default":24}}],"responses":{"200":{"description":"Markdown","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/stats":{"get":{"operationId":"getStats","summary":"Feed statistics","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["all","en","cs"],"default":"all"}}],"responses":{"200":{"description":"Statistics","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/categories":{"get":{"operationId":"listCategories","summary":"Categories with counts","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["en","cs","cz"],"default":"en"},"description":"Language of the article set (cz is an alias of cs)."}],"responses":{"200":{"description":"Categories","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/feed.xml":{"get":{"operationId":"getRssFeed","summary":"RSS 2.0","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["en","cs","cz"],"default":"en"},"description":"Language of the article set (cz is an alias of cs)."},{"name":"category","in":"query","schema":{"type":"string"},"example":"ai,science","description":"Comma-separated: ai, technology, business, science, other."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}}],"responses":{"200":{"description":"RSS","content":{"application/rss+xml":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"Article":{"type":"object","properties":{"id":{"type":"integer"},"lang":{"type":"string","enum":["en","cs"]},"title":{"type":"string"},"summary":{"type":"string"},"category":{"type":"string","enum":["ai","technology","business","science","other"]},"category_label":{"type":"string"},"published_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"url":{"type":"string","format":"uri"},"api_url":{"type":"string","format":"uri"},"markdown_url":{"type":"string","format":"uri"},"image_url":{"type":["string","null"],"format":"uri"},"word_count":{"type":"integer"},"reading_time_minutes":{"type":"integer"},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"domain":{"type":"string"}}}},"translation":{"type":["object","null"],"properties":{"lang":{"type":"string"},"id":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"api_url":{"type":"string","format":"uri"}}},"content":{"type":"string","description":"Plain text, paragraphs separated by a blank line."}}},"ArticleList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Article"}},"meta":{"type":"object"},"links":{"type":"object"}}},"Error":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"param":{"type":"string"},"docs":{"type":"string"}}}},"responses":{"Error":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}