{"openapi":"3.0.3","info":{"title":"GitHub Developer Data API (ReefAPI)","version":"1.0.0","description":"GitHub Developer Data — official REST API profiles, repos, issues, pulls, commits, code search Call POST /github/v1/{action} with an x-api-key header; every response is the { ok, data, meta, error } envelope.","contact":{"name":"ReefAPI","url":"https://reefapi.com/github-api","email":"support@reefapi.com"},"license":{"name":"ReefAPI Terms","url":"https://reefapi.com/terms"},"termsOfService":"https://reefapi.com/terms"},"externalDocs":{"description":"GitHub Developer Data API documentation","url":"https://reefapi.com/docs/github"},"servers":[{"url":"https://api.reefapi.com"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"github","description":"GitHub Developer Data — official REST API profiles, repos, issues, pulls, commits, code search"}],"paths":{"/github/v1/user":{"post":{"operationId":"github_user","summary":"GitHub user profile","description":"GitHub user profile","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","example":"torvalds","description":"GitHub user login (the @handle, without the @)."},"anon_tier":{"type":"string","enum":["1","true"],"example":"1","description":"Set to 1/true to deliberately use the anonymous GitHub API tier (no token, GitHub's own 60/hr anonymous ceiling) instead of a pooled PAT. Normally the engine auto-selects a PAT and only falls back to anonymous when no token has budget; this forces the anonymous path."}},"required":["username"]},"example":{"username":"torvalds"}}}},"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}},"/github/v1/user_repos":{"post":{"operationId":"github_user_repos","summary":"repositories owned by a user","description":"repositories owned by a user","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","example":"torvalds","description":"GitHub user login (the @handle, without the @)."},"type":{"type":"string","enum":["all","owner","member","public","private","forks","sources"],"example":"all","description":"Filter the repository list by relationship/visibility (accepted values vary slightly between user and org endpoints)."},"sort":{"type":"string","enum":["created","updated","pushed","full_name"],"example":"updated","description":"Field to sort repositories by."},"direction":{"type":"string","enum":["asc","desc"],"example":"desc","description":"Sort direction."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["username"]},"example":{"username":"torvalds"}}}},"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}},"/github/v1/user_followers":{"post":{"operationId":"github_user_followers","summary":"followers for a user","description":"followers for a user","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","example":"torvalds","description":"GitHub user login (the @handle, without the @)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["username"]},"example":{"username":"torvalds"}}}},"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}},"/github/v1/user_following":{"post":{"operationId":"github_user_following","summary":"accounts followed by a user","description":"accounts followed by a user","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","example":"tiangolo","description":"GitHub user login (the @handle, without the @)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["username"]},"example":{"username":"torvalds"}}}},"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}},"/github/v1/user_gists":{"post":{"operationId":"github_user_gists","summary":"public gists for a user","description":"public gists for a user","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","example":"torvalds","description":"GitHub user login (the @handle, without the @)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["username"]},"example":{"username":"torvalds"}}}},"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}},"/github/v1/repo":{"post":{"operationId":"github_repo","summary":"repository metadata","description":"repository metadata","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"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}},"/github/v1/repo_issues":{"post":{"operationId":"github_repo_issues","summary":"repository issues","description":"repository issues","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"state":{"type":"string","enum":["open","closed","all"],"example":"open","description":"Filter issues/pull requests by state."},"since":{"type":"string","example":"2024-01-01T00:00:00Z","description":"Only records updated at/after this ISO-8601 timestamp."},"sort":{"type":"string","enum":["created","updated","comments"],"example":"created","description":"Field to sort issues by."},"direction":{"type":"string","enum":["asc","desc"],"example":"desc","description":"Sort direction."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"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}},"/github/v1/repo_pulls":{"post":{"operationId":"github_repo_pulls","summary":"repository pull requests","description":"repository pull requests","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"state":{"type":"string","enum":["open","closed","all"],"example":"open","description":"Filter issues/pull requests by state."},"sort":{"type":"string","enum":["created","updated","popularity","long-running"],"example":"created","description":"Field to sort pull requests by."},"direction":{"type":"string","enum":["asc","desc"],"example":"desc","description":"Sort direction."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"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}},"/github/v1/repo_commits":{"post":{"operationId":"github_repo_commits","summary":"repository commits","description":"repository commits","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"sha":{"type":"string","example":"main","description":"Commit listing: branch name or commit SHA to start from (defaults to the repository's default branch)."},"path":{"type":"string","example":"src/index.js","description":"Only commits that touch this file path."},"author":{"type":"string","example":"gaearon","description":"Only commits by this GitHub login or email."},"since":{"type":"string","example":"2024-01-01T00:00:00Z","description":"Only records updated at/after this ISO-8601 timestamp."},"until":{"type":"string","example":"2024-12-31T23:59:59Z","description":"Only commits before this ISO-8601 timestamp."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"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}},"/github/v1/repo_contributors":{"post":{"operationId":"github_repo_contributors","summary":"repository contributors","description":"repository contributors","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"anon":{"type":"string","enum":["1","true"],"example":"1","description":"Set to 1/true to also include anonymous contributors."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"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}},"/github/v1/repo_releases":{"post":{"operationId":"github_repo_releases","summary":"repository releases","description":"repository releases","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"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}},"/github/v1/repo_stargazers":{"post":{"operationId":"github_repo_stargazers","summary":"recent stargazers of a repository","description":"recent stargazers of a repository","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"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}},"/github/v1/repo_forks":{"post":{"operationId":"github_repo_forks","summary":"repository forks","description":"repository forks","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"sort":{"type":"string","enum":["newest","oldest","stargazers","watchers"],"example":"newest","description":"Field to sort forks by."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"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}},"/github/v1/repo_languages":{"post":{"operationId":"github_repo_languages","summary":"repository language byte counts","description":"repository language byte counts","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"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}},"/github/v1/repo_contents":{"post":{"operationId":"github_repo_contents","summary":"repository content metadata for a path","description":"repository content metadata for a path","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"path":{"type":"string","example":"README.md","description":"Path to a file or directory inside the repository (omit or '/' for the repository root)."},"ref":{"type":"string","example":"main","description":"Branch, tag, or commit SHA to read from (defaults to the default branch)."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"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}},"/github/v1/repo_readme":{"post":{"operationId":"github_repo_readme","summary":"repository README metadata/content URL","description":"repository README metadata/content URL","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"ref":{"type":"string","example":"main","description":"Branch, tag, or commit SHA to read from (defaults to the default branch)."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"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}},"/github/v1/org":{"post":{"operationId":"github_org","summary":"organization profile","description":"organization profile","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org":{"type":"string","example":"github","description":"GitHub organization login."}},"required":["org"]},"example":{"org":"facebook"}}}},"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}},"/github/v1/org_repos":{"post":{"operationId":"github_org_repos","summary":"organization repositories","description":"organization repositories","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org":{"type":"string","example":"github","description":"GitHub organization login."},"type":{"type":"string","enum":["all","owner","member","public","private","forks","sources"],"example":"all","description":"Filter the repository list by relationship/visibility (accepted values vary slightly between user and org endpoints)."},"sort":{"type":"string","enum":["created","updated","pushed","full_name"],"example":"updated","description":"Field to sort repositories by."},"direction":{"type":"string","enum":["asc","desc"],"example":"desc","description":"Sort direction."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["org"]},"example":{"org":"facebook","per_page":10}}}},"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}},"/github/v1/org_members":{"post":{"operationId":"github_org_members","summary":"public organization members","description":"public organization members","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org":{"type":"string","example":"github","description":"GitHub organization login."},"filter":{"type":"string","enum":["all","2fa_disabled"],"example":"all","description":"Filter organization members."},"role":{"type":"string","enum":["all","admin","member"],"example":"all","description":"Filter organization members by role."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["org"]},"example":{"org":"facebook","per_page":10}}}},"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}},"/github/v1/search_repos":{"post":{"operationId":"github_search_repos","summary":"search repositories","description":"search repositories","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","example":"fastapi","description":"GitHub search query, including qualifiers (e.g. 'language:python stars:>1000', 'author:torvalds')."},"sort":{"type":"string","enum":["stars","forks","help-wanted-issues","updated"],"example":"stars","description":"Field to sort search results by (omit for best-match relevance)."},"order":{"type":"string","enum":["desc","asc"],"example":"desc","description":"Sort direction for search results (only applies when sort is set)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."}},"required":["q"]},"example":{"q":"fastapi","per_page":5}}}},"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}},"/github/v1/search_users":{"post":{"operationId":"github_search_users","summary":"search users","description":"search users","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","example":"fastapi","description":"GitHub search query, including qualifiers (e.g. 'language:python stars:>1000', 'author:torvalds')."},"sort":{"type":"string","enum":["followers","repositories","joined"],"example":"followers","description":"Field to sort search results by (omit for best-match relevance)."},"order":{"type":"string","enum":["desc","asc"],"example":"desc","description":"Sort direction for search results (only applies when sort is set)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."}},"required":["q"]},"example":{"q":"fastapi"}}}},"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}},"/github/v1/search_code":{"post":{"operationId":"github_search_code","summary":"search code (token required by GitHub)","description":"search code (token required by GitHub)","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","example":"fastapi","description":"GitHub search query, including qualifiers (e.g. 'language:python stars:>1000', 'author:torvalds')."},"sort":{"type":"string","enum":["indexed"],"example":"indexed","description":"Field to sort search results by (omit for best-match relevance)."},"order":{"type":"string","enum":["desc","asc"],"example":"desc","description":"Sort direction for search results (only applies when sort is set)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."}},"required":["q"]},"example":{"q":"fastapi"}}}},"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":3}},"/github/v1/search_issues":{"post":{"operationId":"github_search_issues","summary":"search issues and pull requests","description":"search issues and pull requests","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","example":"fastapi","description":"GitHub search query, including qualifiers (e.g. 'language:python stars:>1000', 'author:torvalds')."},"sort":{"type":"string","enum":["comments","created","updated","reactions"],"example":"created","description":"Field to sort search results by (omit for best-match relevance)."},"order":{"type":"string","enum":["desc","asc"],"example":"desc","description":"Sort direction for search results (only applies when sort is set)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."}},"required":["q"]},"example":{"q":"fastapi"}}}},"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}},"/github/v1/search_topics":{"post":{"operationId":"github_search_topics","summary":"search GitHub topics","description":"search GitHub topics","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","example":"fastapi","description":"GitHub search query, including qualifiers (e.g. 'language:python stars:>1000', 'author:torvalds')."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."}},"required":["q"]},"example":{"q":"fastapi"}}}},"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}},"/github/v1/search_commits":{"post":{"operationId":"github_search_commits","summary":"search commits across GitHub","description":"search commits across GitHub","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","example":"fastapi","description":"GitHub search query, including qualifiers (e.g. 'language:python stars:>1000', 'author:torvalds')."},"sort":{"type":"string","enum":["author-date","committer-date"],"example":"author-date","description":"Field to sort search results by (omit for best-match relevance)."},"order":{"type":"string","enum":["desc","asc"],"example":"desc","description":"Sort direction for search results (only applies when sort is set)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."}},"required":["q"]},"example":{"q":"fastapi"}}}},"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}},"/github/v1/repo_branches":{"post":{"operationId":"github_repo_branches","summary":"repository branches","description":"repository branches","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react","per_page":5}}}},"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}},"/github/v1/repo_tags":{"post":{"operationId":"github_repo_tags","summary":"repository tags","description":"repository tags","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react","per_page":5}}}},"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}},"/github/v1/repo_topics":{"post":{"operationId":"github_repo_topics","summary":"repository topics (labels)","description":"repository topics (labels)","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"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}},"/github/v1/issue_detail":{"post":{"operationId":"github_issue_detail","summary":"single issue detail","description":"single issue detail","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"number":{"type":"integer","minimum":1,"example":42,"description":"Issue or pull request number (the #N shown in the GitHub UI)."}},"required":["owner","repo","number"]},"example":{"owner":"facebook","repo":"react","number":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}},"/github/v1/issue_comments":{"post":{"operationId":"github_issue_comments","summary":"comments on an issue or PR","description":"comments on an issue or PR","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"number":{"type":"integer","minimum":1,"example":42,"description":"Issue or pull request number (the #N shown in the GitHub UI)."},"since":{"type":"string","example":"2024-01-01T00:00:00Z","description":"Only records updated at/after this ISO-8601 timestamp."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["owner","repo","number"]},"example":{"owner":"facebook","repo":"react","number":1,"per_page":10}}}},"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}},"/github/v1/pull_detail":{"post":{"operationId":"github_pull_detail","summary":"single pull request detail","description":"single pull request detail","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"number":{"type":"integer","minimum":1,"example":42,"description":"Issue or pull request number (the #N shown in the GitHub UI)."}},"required":["owner","repo","number"]},"example":{"owner":"facebook","repo":"react","number":18000}}}},"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}},"/github/v1/pull_reviews":{"post":{"operationId":"github_pull_reviews","summary":"reviews on a pull request","description":"reviews on a pull request","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"number":{"type":"integer","minimum":1,"example":28000,"description":"Issue or pull request number (the #N shown in the GitHub UI)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["owner","repo","number"]},"example":{"owner":"facebook","repo":"react","number":18000,"per_page":10}}}},"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}},"/github/v1/pull_files":{"post":{"operationId":"github_pull_files","summary":"files changed in a pull request","description":"files changed in a pull request","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"number":{"type":"integer","minimum":1,"example":42,"description":"Issue or pull request number (the #N shown in the GitHub UI)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["owner","repo","number"]},"example":{"owner":"facebook","repo":"react","number":18000,"per_page":10}}}},"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}},"/github/v1/pull_commits":{"post":{"operationId":"github_pull_commits","summary":"commits in a pull request","description":"commits in a pull request","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"number":{"type":"integer","minimum":1,"example":42,"description":"Issue or pull request number (the #N shown in the GitHub UI)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["owner","repo","number"]},"example":{"owner":"facebook","repo":"react","number":18000,"per_page":10}}}},"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}},"/github/v1/commit_detail":{"post":{"operationId":"github_commit_detail","summary":"single commit detail with diff stats and changed files","description":"single commit detail with diff stats and changed files","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","example":"facebook","description":"Repository owner — the user or organization login (the part before the slash in owner/repo)."},"repo":{"type":"string","example":"react","description":"Repository name (the part after the slash in owner/repo)."},"sha":{"type":"string","example":"main","description":"Commit SHA (full or short) — or a branch/tag name that resolves to a commit — to fetch the single-commit detail for."}},"required":["owner","repo","sha"]},"example":{"owner":"facebook","repo":"react","sha":"8d259093bf383a1fbbe69eae0fd5c5f615af252b"}}}},"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}},"/github/v1/user_events":{"post":{"operationId":"github_user_events","summary":"public activity events for a user","description":"public activity events for a user","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","example":"torvalds","description":"GitHub user login (the @handle, without the @)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["username"]},"example":{"username":"torvalds"}}}},"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}},"/github/v1/user_orgs":{"post":{"operationId":"github_user_orgs","summary":"organizations a user belongs to (public)","description":"organizations a user belongs to (public)","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","example":"tiangolo","description":"GitHub user login (the @handle, without the @)."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["username"]},"example":{"username":"torvalds"}}}},"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}},"/github/v1/user_starred":{"post":{"operationId":"github_user_starred","summary":"repositories a user has starred","description":"repositories a user has starred","tags":["github"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","example":"torvalds","description":"GitHub user login (the @handle, without the @)."},"sort":{"type":"string","enum":["created","updated"],"example":"created","description":"Field to sort starred repositories by."},"direction":{"type":"string","enum":["asc","desc"],"example":"desc","description":"Sort direction."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number. Page forward with meta.next_page."},"per_page":{"type":"integer","minimum":1,"maximum":100,"default":100,"example":30,"description":"Results per page (1-100, default 100). Larger values are clamped."},"cursor":{"type":"string","example":"Y3Vyc29yOjEw","description":"Opaque pagination cursor (forwarded as ?after=). Use the value from meta.next_cursor; ignored by the search_* actions."}},"required":["username"]},"example":{"username":"torvalds"}}}},"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}},"/github/v1/rate_limit":{"post":{"operationId":"github_rate_limit","summary":"current token/IP rate-limit status","description":"current token/IP rate-limit status","tags":["github"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"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"}}}}}}}}