Get best email addresses by GitHub node IDs

Changed on

Fetch the best email address for GitHub users by their node IDs. 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 IDs). Requires RAW service. Credits: 1 per result returned.

post/users/best-email

Request

Request body

githubIdsstring[] required

Array of GitHub node IDs (1-100)

Example request

{
  "githubIds": [
    "MDQ6VXNlcjU4MzIzMQ==",
    "MDQ6VXNlcjE="
  ]
}

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
}

Changes

    • warning

      added the new FORMER enum value to the // response property for the response status

    • warning

      added the new SCHOOL enum value to the // response property for the response status