{"openapi":"3.0.3","info":{"title":"Stack Overflow API (ReefAPI)","version":"0.1.0","description":"Stack Overflow API — Q&A data scraper: questions, answers, tags, users, badges, search Call POST /stackoverflow/v1/{action} with an x-api-key header; every response is the { ok, data, meta, error } envelope.","contact":{"name":"ReefAPI","url":"https://reefapi.com/stackoverflow-api","email":"support@reefapi.com"},"license":{"name":"ReefAPI Terms","url":"https://reefapi.com/terms"},"termsOfService":"https://reefapi.com/terms"},"externalDocs":{"description":"Stack Overflow API documentation","url":"https://reefapi.com/docs/stackoverflow"},"servers":[{"url":"https://api.reefapi.com"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"stackoverflow","description":"Stack Overflow API — Q&A data scraper: questions, answers, tags, users, badges, search"}],"paths":{"/stackoverflow/v1/questions":{"post":{"operationId":"stackoverflow_questions","summary":"Paginated questions by sort/tag; returns score, tags, body, owner/link attribution.","description":"Paginated questions by sort/tag; returns score, tags, body, owner/link attribution.","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"tag":{"type":"string","example":"python","description":"Optional tag filter (one tag, or several joined by ';' for AND)."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}}},"example":{"sort":"votes"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/question":{"post":{"operationId":"stackoverflow_question","summary":"Single question by id plus paginated answers.","description":"Single question by id plus paginated answers.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"11227809","description":"Question id (or semicolon/comma-joined ids for batch routes)."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"votes","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/answers":{"post":{"operationId":"stackoverflow_answers","summary":"Answer details by id/ids, or recent answers when no id is supplied.","description":"Answer details by id/ids, or recent answers when no id is supplied.","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"11227902","description":"Optional answer id(s) joined by ';'/','; omit for recent answers."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}}},"example":{"sort":"votes"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user":{"post":{"operationId":"stackoverflow_user","summary":"User profile by id/ids.","description":"User profile by id/ids.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"22656","description":"Stack Exchange user id (or several joined by ';' or ',')."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."}},"required":["id"]},"example":{"id":22656}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_questions":{"post":{"operationId":"stackoverflow_user_questions","summary":"Paginated questions for a user.","description":"Paginated questions for a user.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"22656","description":"Stack Exchange user id (or several joined by ';' or ',')."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_answers":{"post":{"operationId":"stackoverflow_user_answers","summary":"Paginated answers for a user.","description":"Paginated answers for a user.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"22656","description":"Stack Exchange user id (or several joined by ';' or ',')."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_tags":{"post":{"operationId":"stackoverflow_user_tags","summary":"Paginated tag activity for a user.","description":"Paginated tag activity for a user.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"22656","description":"Stack Exchange user id (or several joined by ';' or ',')."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"popular","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_badges":{"post":{"operationId":"stackoverflow_user_badges","summary":"Paginated badges for a user.","description":"Paginated badges for a user.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"22656","description":"Stack Exchange user id (or several joined by ';' or ',')."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"rank","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/search":{"post":{"operationId":"stackoverflow_search","summary":"Advanced full-text/tag search, paginated.","description":"Advanced full-text/tag search, paginated.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","example":"async await","description":"Free-text search query (matched against title and body)."},"tag":{"type":"string","example":"python","description":"Optional tag filter (one tag, or several joined by ';' for AND)."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"relevance","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["q"]},"example":{"q":"async await"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}},"/stackoverflow/v1/tags":{"post":{"operationId":"stackoverflow_tags","summary":"Paginated Stack Exchange tags.","description":"Paginated Stack Exchange tags.","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"popular","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/tag_questions":{"post":{"operationId":"stackoverflow_tag_questions","summary":"Paginated questions for a tag.","description":"Paginated questions for a tag.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"type":"string","example":"python","description":"Exact tag name (e.g. 'python', 'c++')."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["tag"]},"example":{"tag":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/tag_info":{"post":{"operationId":"stackoverflow_tag_info","summary":"Tag info by tag name.","description":"Tag info by tag name.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"type":"string","example":"python","description":"Exact tag name (e.g. 'python', 'c++')."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."}},"required":["tag"]},"example":{"tag":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/comments":{"post":{"operationId":"stackoverflow_comments","summary":"Paginated comments for post id/ids.","description":"Paginated comments for post id/ids.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"11227809","description":"Post/answer/comment id (or several joined by ';' or ',')."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/answer_comments":{"post":{"operationId":"stackoverflow_answer_comments","summary":"Comments left on one or more answers, by answer id.","description":"Comments left on one or more answers, by answer id.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"11227902","description":"Target answer id; join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["ids"]},"example":{"ids":11227902}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/answer_questions":{"post":{"operationId":"stackoverflow_answer_questions","summary":"The questions that the given answers belong to, by answer id.","description":"The questions that the given answers belong to, by answer id.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"11227902","description":"Target answer id; join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["ids"]},"example":{"ids":11227902}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/badges":{"post":{"operationId":"stackoverflow_badges","summary":"All badges on the site, ranked bronze/silver/gold.","description":"All badges on the site, ranked bronze/silver/gold.","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"rank","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/badge":{"post":{"operationId":"stackoverflow_badge","summary":"Badge details by badge id.","description":"Badge details by badge id.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"1","description":"Target badge id (1 = Teacher); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"rank","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["ids"]},"example":{"ids":9}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/badge_name":{"post":{"operationId":"stackoverflow_badge_name","summary":"Named badges (the ones with a fixed name, e.g","description":"Named badges (the ones with a fixed name, e.g. 'Nice Answer').","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"rank","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}}},"example":{"pagesize":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/badge_recipients":{"post":{"operationId":"stackoverflow_badge_recipients","summary":"Recently awarded badges across the site, with the users who earned them.","description":"Recently awarded badges across the site, with the users who earned them.","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"rank","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/badge_recipients_by_ids":{"post":{"operationId":"stackoverflow_badge_recipients_by_ids","summary":"Recent recipients of specific badges, by badge id.","description":"Recent recipients of specific badges, by badge id.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"1","description":"Target badge id (1 = Teacher); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"rank","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["ids"]},"example":{"ids":9}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/badge_tags":{"post":{"operationId":"stackoverflow_badge_tags","summary":"Tag-based badges (badges earned for activity within a tag).","description":"Tag-based badges (badges earned for activity within a tag).","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"rank","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/collectives":{"post":{"operationId":"stackoverflow_collectives","summary":"All Stack Overflow Collectives (curated communities like 'Google Cloud').","description":"All Stack Overflow Collectives (curated communities like 'Google Cloud').","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/collective":{"post":{"operationId":"stackoverflow_collective","summary":"Details for a Collective by its slug.","description":"Details for a Collective by its slug.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slugs":{"type":"string","example":"google-cloud","description":"Stack Overflow Collective slug (e.g. 'google-cloud'); join several with ';'."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["slugs"]},"example":{"slugs":"google-cloud"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/collective_questions":{"post":{"operationId":"stackoverflow_collective_questions","summary":"Questions associated with a Collective.","description":"Questions associated with a Collective.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slugs":{"type":"string","example":"google-cloud","description":"Stack Overflow Collective slug (e.g. 'google-cloud'); join several with ';'."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["slugs"]},"example":{"slugs":"google-cloud"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/collective_answers":{"post":{"operationId":"stackoverflow_collective_answers","summary":"Answers associated with a Collective.","description":"Answers associated with a Collective.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slugs":{"type":"string","example":"google-cloud","description":"Stack Overflow Collective slug (e.g. 'google-cloud'); join several with ';'."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["slugs"]},"example":{"slugs":"google-cloud","pagesize":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/collective_tags":{"post":{"operationId":"stackoverflow_collective_tags","summary":"Tags that belong to a Collective.","description":"Tags that belong to a Collective.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slugs":{"type":"string","example":"google-cloud","description":"Stack Overflow Collective slug (e.g. 'google-cloud'); join several with ';'."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"popular","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["slugs"]},"example":{"slugs":"google-cloud"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/collective_users":{"post":{"operationId":"stackoverflow_collective_users","summary":"Members of a Collective, by reputation.","description":"Members of a Collective, by reputation.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slugs":{"type":"string","example":"google-cloud","description":"Stack Overflow Collective slug (e.g. 'google-cloud'); join several with ';'."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"reputation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["slugs"]},"example":{"slugs":"google-cloud"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/comments_all":{"post":{"operationId":"stackoverflow_comments_all","summary":"Recent comments across the whole site.","description":"Recent comments across the whole site.","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/comment":{"post":{"operationId":"stackoverflow_comment","summary":"Comment details by comment id.","description":"Comment details by comment id.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"136733980","description":"Target comment id; join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["ids"]},"example":{"ids":87601479}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/info":{"post":{"operationId":"stackoverflow_info","summary":"Site statistics: total questions, answers, users, badges, API revision.","description":"Site statistics: total questions, answers, users, badges, API revision.","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/posts":{"post":{"operationId":"stackoverflow_posts","summary":"Recent posts (questions and answers together) across the site.","description":"Recent posts (questions and answers together) across the site.","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}}},"example":{"pagesize":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/post":{"post":{"operationId":"stackoverflow_post","summary":"Post details by id, whether it is a question or an answer.","description":"Post details by id, whether it is a question or an answer.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"11227809","description":"Target post id (a question or an answer); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["ids"]},"example":{"ids":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/post_comments":{"post":{"operationId":"stackoverflow_post_comments","summary":"Comments on a post (question or answer), by post id.","description":"Comments on a post (question or answer), by post id.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"11227809","description":"Target post id (a question or an answer); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["ids"]},"example":{"ids":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/post_revisions":{"post":{"operationId":"stackoverflow_post_revisions","summary":"Edit history (revisions) of a post, by post id.","description":"Edit history (revisions) of a post, by post id.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"11227809","description":"Target post id (a question or an answer); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["ids"]},"example":{"ids":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/post_suggested_edits":{"post":{"operationId":"stackoverflow_post_suggested_edits","summary":"Suggested edits submitted for a post, by post id.","description":"Suggested edits submitted for a post, by post id.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"11227809","description":"Target post id (a question or an answer); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["ids"]},"example":{"ids":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/privileges":{"post":{"operationId":"stackoverflow_privileges","summary":"The site privilege ladder (what each reputation level unlocks).","description":"The site privilege ladder (what each reputation level unlocks).","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/question_answers":{"post":{"operationId":"stackoverflow_question_answers","summary":"All answers to one or more questions, by question id.","description":"All answers to one or more questions, by question id.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"11227809","description":"Target question id; join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"votes","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["ids"]},"example":{"ids":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/question_comments":{"post":{"operationId":"stackoverflow_question_comments","summary":"Comments on a question, by question id.","description":"Comments on a question, by question id.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"11227809","description":"Target question id; join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["ids"]},"example":{"ids":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/question_linked":{"post":{"operationId":"stackoverflow_question_linked","summary":"Questions that link to the given question(s).","description":"Questions that link to the given question(s).","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"11227809","description":"Target question id; join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["ids"]},"example":{"ids":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/question_related":{"post":{"operationId":"stackoverflow_question_related","summary":"Questions Stack Overflow considers related to the given question(s).","description":"Questions Stack Overflow considers related to the given question(s).","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"11227809","description":"Target question id; join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["ids"]},"example":{"ids":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/question_timeline":{"post":{"operationId":"stackoverflow_question_timeline","summary":"Full event timeline of a question (edits, answers, comments, votes, close/reopen).","description":"Full event timeline of a question (edits, answers, comments, votes, close/reopen).","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"11227809","description":"Target question id; join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["ids"]},"example":{"ids":11227809,"pagesize":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/questions_featured":{"post":{"operationId":"stackoverflow_questions_featured","summary":"Featured (bountied) questions on the site.","description":"Featured (bountied) questions on the site.","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}}},"example":{"site":"math","pagesize":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/questions_no_answers":{"post":{"operationId":"stackoverflow_questions_no_answers","summary":"Questions with zero answers (no answers at all).","description":"Questions with zero answers (no answers at all).","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/questions_unanswered":{"post":{"operationId":"stackoverflow_questions_unanswered","summary":"Questions the community considers unanswered (no accepted/upvoted answer).","description":"Questions the community considers unanswered (no accepted/upvoted answer).","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/revisions":{"post":{"operationId":"stackoverflow_revisions","summary":"Revision details by revision guid.","description":"Revision details by revision guid.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"5D4D2E7F-95BE-4A9A-AEF5-E911A07BD06E","description":"Target revision GUID; join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["ids"]},"example":{"ids":"5D4D2E7F-95BE-4A9A-AEF5-E911A07BD06E"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/search_simple":{"post":{"operationId":"stackoverflow_search_simple","summary":"Title-only question search — find questions whose title contains given text.","description":"Title-only question search — find questions whose title contains given text.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"intitle":{"type":"string","example":"python decorator","description":"Text that must appear in the question title."},"tag":{"type":"string","example":"python","description":"Optional tag filter (one tag, or several joined by ';' for AND)."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["intitle"]},"example":{"intitle":"sort a list"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/similar":{"post":{"operationId":"stackoverflow_similar","summary":"Find questions similar to a title (duplicate detection).","description":"Find questions similar to a title (duplicate detection).","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","example":"how to merge dictionaries","description":"Title text to find similar/duplicate questions for."},"tag":{"type":"string","example":"python","description":"Optional tag filter (one tag, or several joined by ';' for AND)."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"relevance","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["title"]},"example":{"title":"How to sort a list in Python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}},"/stackoverflow/v1/search_excerpts":{"post":{"operationId":"stackoverflow_search_excerpts","summary":"Full-text search returning highlighted match excerpts for questions and answers.","description":"Full-text search returning highlighted match excerpts for questions and answers.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","example":"async await","description":"Free-text search query (matched against title and body)."},"tag":{"type":"string","example":"python","description":"Optional tag filter (one tag, or several joined by ';' for AND)."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"relevance","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["q"]},"example":{"q":"async await"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}},"/stackoverflow/v1/suggested_edits":{"post":{"operationId":"stackoverflow_suggested_edits","summary":"Recent suggested edits across the site.","description":"Recent suggested edits across the site.","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/suggested_edit":{"post":{"operationId":"stackoverflow_suggested_edit","summary":"Suggested-edit details by id.","description":"Suggested-edit details by id.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"100","description":"Target suggested-edit id; join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["ids"]},"example":{"ids":5584475}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/tags_moderator_only":{"post":{"operationId":"stackoverflow_tags_moderator_only","summary":"Tags only moderators can apply.","description":"Tags only moderators can apply.","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"popular","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}}},"example":{"site":"meta.stackexchange"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/tags_required":{"post":{"operationId":"stackoverflow_tags_required","summary":"Tags that must be present on every question (where the site requires them).","description":"Tags that must be present on every question (where the site requires them).","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"popular","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}}},"example":{"site":"meta.stackexchange"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/tag_synonyms":{"post":{"operationId":"stackoverflow_tag_synonyms","summary":"All tag synonyms on the site (e.g","description":"All tag synonyms on the site (e.g. 'js' → 'javascript').","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/tag_faq":{"post":{"operationId":"stackoverflow_tag_faq","summary":"The frequently-asked (FAQ) questions for a tag.","description":"The frequently-asked (FAQ) questions for a tag.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"string","example":"c#","description":"Tag name(s) for this route (e.g. 'c#', 'python'); join several with ';'."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["tags"]},"example":{"tags":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/tag_related":{"post":{"operationId":"stackoverflow_tag_related","summary":"Tags that commonly appear together with the given tag.","description":"Tags that commonly appear together with the given tag.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"string","example":"c#","description":"Tag name(s) for this route (e.g. 'c#', 'python'); join several with ';'."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"popular","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["tags"]},"example":{"tags":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/tag_synonyms_by_tags":{"post":{"operationId":"stackoverflow_tag_synonyms_by_tags","summary":"Synonyms that map to a specific tag.","description":"Synonyms that map to a specific tag.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"string","example":"c#","description":"Tag name(s) for this route (e.g. 'c#', 'python'); join several with ';'."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["tags"]},"example":{"tags":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/tag_top_answerers":{"post":{"operationId":"stackoverflow_tag_top_answerers","summary":"Top answerers in a tag (the experts), all-time or last month.","description":"Top answerers in a tag (the experts), all-time or last month.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"type":"string","example":"python","description":"Exact tag name (e.g. 'python', 'c++')."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"period":{"type":"string","enum":["all_time","month"],"default":"all_time","example":"all_time","description":"Time window for top-answerers/top-askers routes (all_time or month)."}},"required":["tag"]},"example":{"tag":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/tag_top_askers":{"post":{"operationId":"stackoverflow_tag_top_askers","summary":"Top askers in a tag, all-time or last month.","description":"Top askers in a tag, all-time or last month.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"type":"string","example":"python","description":"Exact tag name (e.g. 'python', 'c++')."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"period":{"type":"string","enum":["all_time","month"],"default":"all_time","example":"all_time","description":"Time window for top-answerers/top-askers routes (all_time or month)."}},"required":["tag"]},"example":{"tag":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/tag_wikis":{"post":{"operationId":"stackoverflow_tag_wikis","summary":"The wiki/excerpt body that describes a tag.","description":"The wiki/excerpt body that describes a tag.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"string","example":"c#","description":"Tag name(s) for this route (e.g. 'c#', 'python'); join several with ';'."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["tags"]},"example":{"tags":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/users":{"post":{"operationId":"stackoverflow_users","summary":"Site users, by reputation (the leaderboard).","description":"Site users, by reputation (the leaderboard).","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"reputation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_comments":{"post":{"operationId":"stackoverflow_user_comments","summary":"Comments written by a user.","description":"Comments written by a user.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["ids"]},"example":{"ids":22656}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_comments_to_user":{"post":{"operationId":"stackoverflow_user_comments_to_user","summary":"Comments a user directed at one specific other user.","description":"Comments a user directed at one specific other user.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"toid":{"type":"string","example":"17034","description":"Recipient user id (the 'to' user for directed comments) — must differ from the commenting user id."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["ids","toid"]},"example":{"ids":22656,"toid":3744182}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_favorites":{"post":{"operationId":"stackoverflow_user_favorites","summary":"Questions a user bookmarked (favorited).","description":"Questions a user bookmarked (favorited).","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["ids"]},"example":{"ids":11227902}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_mentioned":{"post":{"operationId":"stackoverflow_user_mentioned","summary":"Comments that @-mention a user.","description":"Comments that @-mention a user.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["ids"]},"example":{"ids":22656}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_network_activity":{"post":{"operationId":"stackoverflow_user_network_activity","summary":"A user's activity across the entire Stack Exchange network (all sites).","description":"A user's activity across the entire Stack Exchange network (all sites).","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"22656","description":"Single target id for this route (user/error id as applicable)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_posts":{"post":{"operationId":"stackoverflow_user_posts","summary":"All posts (questions and answers) authored by a user.","description":"All posts (questions and answers) authored by a user.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["ids"]},"example":{"ids":22656}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_privileges":{"post":{"operationId":"stackoverflow_user_privileges","summary":"The privileges a user has unlocked at their reputation level.","description":"The privileges a user has unlocked at their reputation level.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"22656","description":"Single target id for this route (user/error id as applicable)."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_questions_featured":{"post":{"operationId":"stackoverflow_user_questions_featured","summary":"A user's questions that currently carry a bounty (featured).","description":"A user's questions that currently carry a bounty (featured).","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["ids"]},"example":{"ids":11227902}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_questions_no_answers":{"post":{"operationId":"stackoverflow_user_questions_no_answers","summary":"A user's questions that have no answers.","description":"A user's questions that have no answers.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["ids"]},"example":{"ids":179736}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_questions_unaccepted":{"post":{"operationId":"stackoverflow_user_questions_unaccepted","summary":"A user's questions that have answers but none accepted.","description":"A user's questions that have answers but none accepted.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["ids"]},"example":{"ids":179736}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_questions_unanswered":{"post":{"operationId":"stackoverflow_user_questions_unanswered","summary":"A user's questions the community considers unanswered.","description":"A user's questions the community considers unanswered.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"activity","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["ids"]},"example":{"ids":179736}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_reputation":{"post":{"operationId":"stackoverflow_user_reputation","summary":"A user's reputation changes (the rep events feed).","description":"A user's reputation changes (the rep events feed).","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["ids"]},"example":{"ids":22656}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_reputation_history":{"post":{"operationId":"stackoverflow_user_reputation_history","summary":"Public reputation history of a user (each gain/loss event).","description":"Public reputation history of a user (each gain/loss event).","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["ids"]},"example":{"ids":22656}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_suggested_edits":{"post":{"operationId":"stackoverflow_user_suggested_edits","summary":"Suggested edits a user has submitted.","description":"Suggested edits a user has submitted.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"creation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}},"required":["ids"]},"example":{"ids":22656}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_top_answers_in_tags":{"post":{"operationId":"stackoverflow_user_top_answers_in_tags","summary":"A user's highest-scoring answers within specific tags.","description":"A user's highest-scoring answers within specific tags.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"22656","description":"Single target id for this route (user/error id as applicable)."},"tags":{"type":"string","example":"c#","description":"Tag name(s) for this route (e.g. 'c#', 'python'); join several with ';'."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["id","tags"]},"example":{"id":22656,"tags":"c#"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_top_questions_in_tags":{"post":{"operationId":"stackoverflow_user_top_questions_in_tags","summary":"A user's highest-scoring questions within specific tags.","description":"A user's highest-scoring questions within specific tags.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"22656","description":"Single target id for this route (user/error id as applicable)."},"tags":{"type":"string","example":"c#","description":"Tag name(s) for this route (e.g. 'c#', 'python'); join several with ';'."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"filter":{"type":"string","example":"withbody","description":"Stack Exchange filter id controlling which fields are returned (e.g. 'withbody' to include rendered post bodies). Default withbody."}},"required":["id","tags"]},"example":{"id":22656,"tags":"c#"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_timeline":{"post":{"operationId":"stackoverflow_user_timeline","summary":"A user's activity timeline (posts, comments, badges, rep events).","description":"A user's activity timeline (posts, comments, badges, rep events).","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["ids"]},"example":{"ids":22656,"pagesize":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_top_answer_tags":{"post":{"operationId":"stackoverflow_user_top_answer_tags","summary":"The tags a user is strongest in by answer score.","description":"The tags a user is strongest in by answer score.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"22656","description":"Single target id for this route (user/error id as applicable)."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_top_question_tags":{"post":{"operationId":"stackoverflow_user_top_question_tags","summary":"The tags a user is strongest in by question score.","description":"The tags a user is strongest in by question score.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"22656","description":"Single target id for this route (user/error id as applicable)."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/user_top_tags":{"post":{"operationId":"stackoverflow_user_top_tags","summary":"A user's top tags overall (combined question + answer activity).","description":"A user's top tags overall (combined question + answer activity).","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"22656","description":"Single target id for this route (user/error id as applicable)."},"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/moderators":{"post":{"operationId":"stackoverflow_moderators","summary":"All moderators on the site.","description":"All moderators on the site.","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"reputation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/elected_moderators":{"post":{"operationId":"stackoverflow_elected_moderators","summary":"Moderators who were elected (excludes appointed/employee moderators).","description":"Moderators who were elected (excludes appointed/employee moderators).","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string","default":"stackoverflow","example":"stackoverflow","description":"Stack Exchange site slug (e.g. stackoverflow, serverfault, superuser, askubuntu, math). Defaults to stackoverflow."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"reputation","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}}},"example":{"site":"stackoverflow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/errors":{"post":{"operationId":"stackoverflow_errors","summary":"The catalog of Stack Exchange API error codes and their meanings.","description":"The catalog of Stack Exchange API error codes and their meanings.","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}}},"example":{"page":1}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/error":{"post":{"operationId":"stackoverflow_error","summary":"Simulate one Stack Exchange API error by its id (returns the error as if it occurred).","description":"Simulate one Stack Exchange API error by its id (returns the error as if it occurred).","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","enum":["400","401","402","403","404","405","406","407","409","500","502","503"],"example":"404","description":"Stack Exchange ERROR CODE to simulate (NOT a user/post id) — one of the ids listed by the `errors` action, e.g. 404. The simulated error comes back as a normal ok:true payload so you can test your error handling."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/sites":{"post":{"operationId":"stackoverflow_sites","summary":"Every site in the Stack Exchange network (Stack Overflow, Server Fault, Super User, etc.).","description":"Every site in the Stack Exchange network (Stack Overflow, Server Fault, Super User, etc.).","tags":["stackoverflow"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."},"sort":{"type":"string","enum":["activity","creation","votes","relevance","popular","rank","reputation","name","hot","week","month"],"example":"name","description":"Sort key. Valid keys depend on the endpoint (e.g. votes/activity/creation for questions, reputation for users, rank for badges); common keys shown, others pass through to Stack Exchange."}}},"example":{"page":1}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/associated_users":{"post":{"operationId":"stackoverflow_associated_users","summary":"A user's accounts across all Stack Exchange sites (network accounts).","description":"A user's accounts across all Stack Exchange sites (network accounts).","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["ids"]},"example":{"ids":11683}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/stackoverflow/v1/merge_history":{"post":{"operationId":"stackoverflow_merge_history","summary":"Account-merge history for a user id.","description":"Account-merge history for a user id.","tags":["stackoverflow"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string","example":"22656","description":"Target user id (22656 = Jon Skeet); join several with ';' or ','."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"pagesize":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped to 100."},"order":{"type":"string","enum":["desc","asc"],"default":"desc","example":"desc","description":"Sort direction for the chosen sort key."}},"required":["ids"]},"example":{"ids":11683}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"Envelope":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"data":{"description":"Action result (shape varies per action)"},"meta":{"type":"object","description":"api, endpoint, mode, latency_ms, record_count, completeness_pct"},"error":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}}}}}}}}