v43

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-0520621.8 MB

Get best email addresses by GitHub username

Fetch the best email address for GitHub users by their usernames (login). Uses intelligent selection to prioritize personal emails over work emails and verifies domain validity. Returns the best email plus all other email candidates. Supports batch requests (1-100 logins). Requires RAW service. Credits: 1 per result returned.

post/users/best-email/by-login

Request body

loginsstring[] required

Array of GitHub usernames (1-100)

Example request

{
  "logins": [
    "octocat",
    "torvalds"
  ]
}

Response

Best emails retrieved successfully

countnumber required

Number of results returned

Example response

{
  "results": [
    {
      "githubId": "MDQ6VXNlcjU4MzIzMQ==",
      "login": "octocat",
      "bestEmail": "octocat@gmail.com",
      "otherCandidates": [],
      "profile": "WORK"
    }
  ],
  "count": 2
}