The GitHub API from Social Fetch — 10 operation(s) for github.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/social-fetch-github-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Social Fetch Public Git Hub API
version: 1.0.0
description: 'REST API for Social Fetch. Versioned routes under `/v1` accept `x-api-key` credits or x402 USDC on Base (walk-up, no key). OpenAPI: https://api.socialfetch.dev/openapi.json. x402 discovery: https://api.socialfetch.dev/.well-known/x402. MCP: https://api.socialfetch.dev/mcp (POST). Docs and agent guide: https://www.socialfetch.dev/docs and https://www.socialfetch.dev/llms.txt.'
servers:
- url: https://api.socialfetch.dev
description: API origin
tags:
- name: Github
paths:
/v1/github/profiles/{handle}:
get:
tags:
- Github
summary: Get GitHub profile
description: Get a GitHub profile for a user or organization.
security:
- ApiKeyAuth: []
- {}
x-socialfetch-pricing:
version: 1
baseCredits: 1
surcharges: []
maxCredits: 1
normalizationFailureCredits: 1
x-socialfetch-credits-pricing: 1 credit per successful request.
parameters:
- schema:
type: string
minLength: 1
maxLength: 39
description: GitHub username to look up, with or without a leading @.
required: true
description: GitHub username to look up, with or without a leading @.
name: handle
in: path
responses:
'200':
description: GitHub profile lookup result.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
lookupStatus:
type: string
enum:
- found
- not_found
description: Whether the profile was found.
profile:
type:
- object
- 'null'
properties:
platform:
type: string
enum:
- github
description: Social platform for this profile.
handle:
type: string
description: GitHub username (login).
displayName:
type:
- string
- 'null'
description: Public display name when set on the profile.
bio:
type:
- string
- 'null'
description: Profile biography text.
avatarUrl:
type:
- string
- 'null'
description: Avatar image URL when available.
profileUrl:
type: string
minLength: 1
description: Canonical public GitHub profile URL.
platformUserId:
type: string
description: GitHub user or organization id as a string.
nodeId:
type: string
description: GitHub node id when available.
accountType:
type: string
enum:
- User
- Organization
description: Whether this profile is a user or organization account.
company:
type:
- string
- 'null'
description: Company shown on the profile when available.
location:
type:
- string
- 'null'
description: Location shown on the profile when available.
blog:
type:
- string
- 'null'
description: Blog or website URL from the profile when available.
email:
type:
- string
- 'null'
description: Public email when exposed by GitHub.
twitterUsername:
type:
- string
- 'null'
description: Linked X (Twitter) username when set on the profile.
siteAdmin:
type: boolean
description: Whether the account is a GitHub site administrator.
accountCreatedAt:
type: string
description: Account creation timestamp (ISO 8601) when available.
accountUpdatedAt:
type: string
description: Profile last-updated timestamp (ISO 8601) when available.
required:
- platform
- handle
- displayName
- bio
- avatarUrl
- profileUrl
- accountType
description: Profile details when available.
metrics:
type:
- object
- 'null'
properties:
followers:
type:
- integer
- 'null'
minimum: 0
description: Follower count when available.
following:
type:
- integer
- 'null'
minimum: 0
description: Following count when available.
publicRepos:
type:
- integer
- 'null'
minimum: 0
description: Public repository count when available.
publicGists:
type:
- integer
- 'null'
minimum: 0
description: Public gist count when available.
required:
- followers
- following
- publicRepos
- publicGists
description: Profile metrics when available.
required:
- lookupStatus
- profile
- metrics
description: Endpoint-specific response payload.
meta:
type: object
properties:
requestId:
type: string
minLength: 1
description: Unique request identifier for tracing this API call.
creditsCharged:
type: integer
minimum: 0
description: Credits charged for this request.
version:
type: string
enum:
- v1
description: Public API version that served the response.
cached:
type: boolean
description: True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
required:
- requestId
- creditsCharged
- version
description: Metadata describing the request and billing outcome.
required:
- data
- meta
description: Standard success response envelope.
examples:
found:
value:
data:
lookupStatus: found
profile:
platform: github
handle: torvalds
displayName: Linus Torvalds
bio: null
avatarUrl: https://avatars.githubusercontent.com/u/1024025?v=4
profileUrl: https://github.com/torvalds
platformUserId: '1024025'
nodeId: MDQ6VXNlcjEwMjQwMjU=
accountType: User
company: Linux Foundation
location: Portland, OR
email: null
twitterUsername: null
siteAdmin: false
accountCreatedAt: '2011-09-03T15:26:22Z'
accountUpdatedAt: '2026-06-02T05:33:59Z'
metrics:
followers: 306179
following: 0
publicRepos: 12
publicGists: 1
meta:
requestId: req_01example_github_profile
creditsCharged: 1
version: v1
not_found:
value:
data:
lookupStatus: not_found
profile: null
metrics: null
meta:
requestId: req_01example
creditsCharged: 1
version: v1
'400':
description: Invalid handle or bad request
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- bad_request
description: Machine-readable error code for the failed request.
message:
type: string
description: Human-readable error message. May change over time; do not parse it. Use `error.code` and the HTTP status for programmatic handling.
requestId:
type: string
description: Unique request identifier for tracing the failed API call.
checkoutUrl:
type: string
format: uri
description: Optional one-click checkout URL when credits are exhausted and a conversion offer is available.
required:
- code
- message
- requestId
description: Error details for the failed request.
required:
- error
description: Standard error response envelope.
example:
error:
code: bad_request
message: Example message.
requestId: req_01example
'401':
description: Missing or invalid API key
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- unauthorized
description: Machine-readable error code for the failed request.
message:
type: string
description: Human-readable error message. May change over time; do not parse it. Use `error.code` and the HTTP status for programmatic handling.
requestId:
type: string
description: Unique request identifier for tracing the failed API call.
checkoutUrl:
type: string
format: uri
description: Optional one-click checkout URL when credits are exhausted and a conversion offer is available.
required:
- code
- message
- requestId
description: Error details for the failed request.
required:
- error
description: Standard error response envelope.
example:
error:
code: unauthorized
message: Example message.
requestId: req_01example
'402':
description: Insufficient credits
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- insufficient_credits
description: Machine-readable error code for the failed request.
message:
type: string
description: Human-readable error message. May change over time; do not parse it. Use `error.code` and the HTTP status for programmatic handling.
requestId:
type: string
description: Unique request identifier for tracing the failed API call.
checkoutUrl:
type: string
format: uri
description: Optional one-click checkout URL when credits are exhausted and a conversion offer is available.
required:
- code
- message
- requestId
description: Error details for the failed request.
required:
- error
description: Standard error response envelope.
example:
error:
code: insufficient_credits
message: Example message.
requestId: req_01example
'500':
description: Unexpected or billing error
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- internal_error
description: Machine-readable error code for the failed request.
message:
type: string
description: Human-readable error message. May change over time; do not parse it. Use `error.code` and the HTTP status for programmatic handling.
requestId:
type: string
description: Unique request identifier for tracing the failed API call.
checkoutUrl:
type: string
format: uri
description: Optional one-click checkout URL when credits are exhausted and a conversion offer is available.
required:
- code
- message
- requestId
description: Error details for the failed request.
required:
- error
description: Standard error response envelope.
example:
error:
code: internal_error
message: Example message.
requestId: req_01example
'502':
description: Lookup could not be completed from the response (unexpected or invalid data).
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- lookup_failed
description: Machine-readable error code for the failed request.
message:
type: string
description: Human-readable error message. May change over time; do not parse it. Use `error.code` and the HTTP status for programmatic handling.
requestId:
type: string
description: Unique request identifier for tracing the failed API call.
checkoutUrl:
type: string
format: uri
description: Optional one-click checkout URL when credits are exhausted and a conversion offer is available.
required:
- code
- message
- requestId
description: Error details for the failed request.
required:
- error
description: Standard error response envelope.
example:
error:
code: lookup_failed
message: Example message.
requestId: req_01example
'503':
description: Service temporarily unavailable; safe to retry with backoff.
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- temporarily_unavailable
description: Machine-readable error code for the failed request.
message:
type: string
description: Human-readable error message. May change over time; do not parse it. Use `error.code` and the HTTP status for programmatic handling.
requestId:
type: string
description: Unique request identifier for tracing the failed API call.
checkoutUrl:
type: string
format: uri
description: Optional one-click checkout URL when credits are exhausted and a conversion offer is available.
required:
- code
- message
- requestId
description: Error details for the failed request.
required:
- error
description: Standard error response envelope.
example:
error:
code: temporarily_unavailable
message: Example message.
requestId: req_01example
operationId: getV1GithubProfilesByHandle
x-operation-id-source: derived
/v1/github/profiles/{handle}/repositories:
get:
tags:
- Github
summary: List GitHub profile repositories
description: List repositories for a GitHub user or organization.
security:
- ApiKeyAuth: []
- {}
x-socialfetch-pricing:
version: 1
baseCredits: 1
surcharges: []
maxCredits: 1
normalizationFailureCredits: 1
x-socialfetch-credits-pricing: 1 credit per successful request.
parameters:
- schema:
type: string
minLength: 1
maxLength: 39
description: GitHub username whose public repositories should be listed.
required: true
description: GitHub username whose public repositories should be listed.
name: handle
in: path
- schema:
type: string
minLength: 1
description: Pagination cursor returned by a previous response.
required: false
description: Pagination cursor returned by a previous response.
name: cursor
in: query
- schema:
type: string
enum:
- owner
- all
- member
description: 'Repository type filter. `owner`: repos owned by the user. `all`: owned repos plus repos from organizations the user belongs to. `member`: only repos the user belongs to via organization membership (not owned by the user). Default: `owner`.'
required: false
description: 'Repository type filter. `owner`: repos owned by the user. `all`: owned repos plus repos from organizations the user belongs to. `member`: only repos the user belongs to via organization membership (not owned by the user). Default: `owner`.'
name: type
in: query
- schema:
type: string
enum:
- created
- updated
- pushed
- full_name
description: Sort field for repositories.
required: false
description: Sort field for repositories.
name: sort
in: query
- schema:
type: string
enum:
- asc
- desc
description: Sort direction.
required: false
description: Sort direction.
name: direction
in: query
responses:
'200':
description: GitHub repositories lookup result.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
lookupStatus:
type: string
enum:
- found
- not_found
description: Whether the profile resolved for this request.
repositories:
type: array
items:
type: object
properties:
platformRepoId:
type: string
description: GitHub repository id as a string.
nodeId:
type: string
description: GitHub node id when available.
name:
type: string
description: Repository name without the owner prefix.
fullName:
type: string
description: Full repository name in `owner/repo` form.
owner:
type: object
properties:
platformUserId:
type: string
description: GitHub user or organization id as a string.
handle:
type: string
description: GitHub login (username).
avatarUrl:
type:
- string
- 'null'
description: Avatar image URL for the owner.
profileUrl:
type: string
minLength: 1
description: Canonical public GitHub profile URL for the owner.
accountType:
type: string
enum:
- User
- Organization
description: Whether the owner is a user or organization.
required:
- platformUserId
- handle
- avatarUrl
- profileUrl
- accountType
description: Repository owner.
isPrivate:
type: boolean
description: Whether the repository is private.
profileUrl:
type: string
minLength: 1
description: Canonical public GitHub repository URL.
description:
type:
- string
- 'null'
description: Repository description when available.
isFork:
type: boolean
description: Whether the repository is a fork.
homepage:
type:
- string
- 'null'
description: Homepage URL when set on the repository.
language:
type:
- string
- 'null'
description: Primary programming language when reported.
forksCount:
type:
- integer
- 'null'
minimum: 0
description: Fork count when available.
starsCount:
type:
- integer
- 'null'
minimum: 0
description: Star count when available.
watchersCount:
type:
- integer
- 'null'
minimum: 0
description: Watcher count when available.
sizeKb:
type:
- integer
- 'null'
minimum: 0
description: Repository size in kilobytes when available.
defaultBranch:
type:
- string
- 'null'
description: Default branch name when available.
openIssuesCount:
type:
- integer
- 'null'
minimum: 0
description: Open issue count when available.
topics:
type: array
items:
type: string
description: Repository topic tags when available.
license:
type:
- object
- 'null'
properties:
key:
type: string
description: License key identifier.
name:
type: string
description: Human-readable license name.
spdxId:
type:
- string
- 'null'
description: SPDX license identifier when available.
required:
- key
- name
- spdxId
description: License metadata when available.
archived:
type: boolean
description: Whether the repository is archived.
disabled:
type: boolean
description: Whether the repository is disabled.
visibility:
type:
- string
- 'null'
description: Repository visibility label when available.
pushedAt:
type:
- string
- 'null'
description: Last push timestamp (ISO 8601) when available.
createdAt:
type:
- string
- 'null'
description: Creation timestamp (ISO 8601) when available.
updatedAt:
type:
- string
- 'null'
description: Last update timestamp (ISO 8601) when available.
required:
- platformRepoId
- name
- fullName
- owner
- isPrivate
- profileUrl
- description
- isFork
- homepage
- language
- forksCount
- starsCount
- watchersCount
- sizeKb
- defaultBranch
- openIssuesCount
- topics
- license
- archived
- disabled
- visibility
- pushedAt
- createdAt
- updatedAt
description: GitHub repository metadata.
description: Public repositories for the requested profile page.
page:
type: object
properties:
nextCursor:
type:
- string
- 'null'
description: Opaque cursor for the next page, or null when there is no next page.
hasMore:
type: boolean
description: Whether another page of results is available.
required:
- nextCursor
# --- truncated at 32 KB (252 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/social-fetch/refs/heads/main/openapi/social-fetch-github-api-openapi.yml