{"openapi":"3.1.0","info":{"title":"semiconductormagazine.com content API","version":"1.0.0","description":"Read-only access to the expert Q&A, articles, interviews and contributors published on semiconductormagazine.com. Every HTML page is also available as markdown by sending Accept: text/markdown or appending .md. No authentication. Versioning: the path prefix /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 announcing the date. See https://semiconductormagazine.com/llms.txt for when to use this site.","contact":{"email":"community@featured.com"}},"servers":[{"url":"https://semiconductormagazine.com"}],"paths":{"/api/v1/posts/":{"get":{"operationId":"listPosts","summary":"List posts, newest first","description":"Paginated list of published posts. Filter by type to get only Q&A, articles, interviews or news.","parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["qa","insight","interview","news"]},"description":"Post type; omit for all."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"A page of posts","content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"pages":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PostSummary"}}},"required":["site","page","limit","total","pages","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":"Get one post with its full body as markdown","description":"Returns the post metadata, the experts quoted in it, and body_markdown containing the complete text.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"The slug from the post URL."}],"responses":{"200":{"description":"The post","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/PostSummary"},{"type":"object","properties":{"body_markdown":{"type":"string"},"panelists":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"jobTitle":{"type":"string"},"companyName":{"type":"string"}}}}}}]}}}},"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":"List contributors","description":"Every author with a public page and at least one post, busiest first.","responses":{"200":{"description":"Contributors","content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Author"}}},"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/search/":{"get":{"operationId":"searchPosts","summary":"Search posts","description":"Full-text search over titles, summaries and bodies. Best for questions like 'what do experts say about X'.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2},"description":"Search terms."},{"name":"limit","in":"query","required":false,"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"},"query":{"type":"string"},"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PostSummary"}}},"required":["site","query","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":{"_id":{"type":"string"},"type":{"type":"string","enum":["qa","insight","interview","news"]},"title":{"type":"string"},"slug":{"type":"string"},"summary":{"type":"string","nullable":true},"publishDate":{"type":"string","format":"date-time","nullable":true},"author":{"type":"object","nullable":true,"properties":{"authorName":{"type":"string"},"slug":{"type":"string"}}},"tags":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"}}}},"url":{"type":"string","format":"uri"},"markdown":{"type":"string","format":"uri","description":"Same post as text/markdown"}},"required":["_id","type","title","slug","url"]},"Author":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"posts":{"type":"integer"},"latest":{"type":"string","format":"date-time","nullable":true},"expertise":{"type":"array","items":{"type":"string"}},"education":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"},"markdown":{"type":"string","format":"uri"}},"required":["name","slug","posts","url"]},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}