DEVELOPER TOOLS

Get GitHub User Commit Emails API

Collect the public commit-author emails a GitHub user has pushed with, from their most recently updated repositories (noreply addresses dropped). One listing call plus one per repository scanned. Plus the rate-limit headers.

githubemailuserenrichmentdeveloperpython

Try it free Get an API key

How to call it

Send one POST to api.upapi.io/github-user-emails.get with your key in the X-Api-Key header and the parameters below as a JSON body. Each call spends 3 weighted units of your monthly quota. The operation times out after 45 seconds. Identical requests are served from cache for 600 seconds, unbilled.

endpoint

POST https://api.upapi.io/github-user-emails.get

Get GitHub User Commit Emails API reference

Request parameters

token: stringrequired — GitHub token. REQUIRED here, unlike the single-call reads: this operation fans out to 1 + maxRepos requests, so an anonymous call spends up to 11 of the 60 requests an hour that every keyless caller through this worker shares. With a token the budget is the caller's own 5,000/h.
maxRepos: integer — How many of the user's most recently pushed repositories to scan
proxyUrl: string — Optional exit to send from (direct otherwise)
username: stringrequired — GitHub login

Response fields

emails: arrayrequired
emails[].sha: stringrequired
emails[].name: stringrequired
emails[].email: stringrequired
emails[].repository: stringrequired — owner/repo the commit was read from
emails[].committedAt: stringrequired
username: stringrequired
fetchedAt: stringrequired
rateLimit: objectrequired — The rate-limit headers GitHub returned on THIS response, surfaced so the caller can pace itself instead of the operation sleeping on its behalf.
rateLimit.limit: integerrequired — X-RateLimit-Limit: requests allowed per window
rateLimit.resetAt: stringrequired — X-RateLimit-Reset as an ISO-8601 UTC timestamp
rateLimit.resource: stringrequired — X-RateLimit-Resource: which bucket (core, search, graphql, ...)
rateLimit.remaining: integerrequired — X-RateLimit-Remaining: requests left
rateLimit.resetEpoch: integerrequired — X-RateLimit-Reset as unix seconds
reposScanned: arrayrequired

Example request and response

The example response is generated from this operation’s published output schema — it shows the shape and field names, not values from a recorded call.

json — example request body

{
  "token": "example",
  "maxRepos": 3,
  "username": "torvalds"
}

json — example response shape

{
  "emails": [
    {
      "sha": "example",
      "name": "example",
      "email": "test@example.com",
      "repository": "example",
      "committedAt": "example"
    }
  ],
  "username": "torvalds",
  "fetchedAt": "example",
  "rateLimit": {
    "limit": 5,
    "resetAt": "example",
    "resource": "example",
    "remaining": 1,
    "resetEpoch": 1
  },
  "reposScanned": [
    "example"
  ]
}

Code snippets

cURL

curl

curl -X POST https://api.upapi.io/github-user-emails.get \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "token": "example", "maxRepos": 3, "username": "torvalds" }'

JavaScript

javascript

const response = await fetch('https://api.upapi.io/github-user-emails.get', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
  "token": "example",
  "maxRepos": 3,
  "username": "torvalds"
}),
});

const data = await response.json();
console.log(data);

Python

python

import requests

response = requests.post(
    'https://api.upapi.io/github-user-emails.get',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY',
    },
    json={
  "token": "example",
  "maxRepos": 3,
  "username": "torvalds"
},
)

print(response.json())

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{ "token": "example", "maxRepos": 3, "username": "torvalds" }`)

	req, _ := http.NewRequest("POST", "https://api.upapi.io/github-user-emails.get", bytes.NewBuffer(payload))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("x-api-key", "YOUR_API_KEY")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	var result map[string]any
	json.Unmarshal(body, &result)
	fmt.Println(result)
}

PHP

php

<?php

$payload = json_encode([
    'token' => 'example',
    'maxRepos' => 3,
    'username' => 'torvalds',
]);

$ch = curl_init('https://api.upapi.io/github-user-emails.get');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'x-api-key: YOUR_API_KEY',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
var_dump($data);

Ruby

ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.upapi.io/github-user-emails.get')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'

request = Net::HTTP::Post.new(uri.path)
request['Content-Type'] = 'application/json'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = { "token": "example", "maxRepos": 3, "username": "torvalds" }.to_json

response = http.request(request)
puts JSON.parse(response.body)

Java

java

import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;

OkHttpClient client = new OkHttpClient();
ObjectMapper mapper = new ObjectMapper();

String json = "{ \"token\": \"example\", \"maxRepos\": 3, \"username\": \"torvalds\" }";

RequestBody body = RequestBody.create(json, MediaType.get("application/json"));
Request request = new Request.Builder()
    .url("https://api.upapi.io/github-user-emails.get")
    .post(body)
    .addHeader("Content-Type", "application/json")
    .addHeader("x-api-key", "YOUR_API_KEY")
    .build();

try (Response response = client.newCall(request).execute()) {
    Map<?, ?> result = mapper.readValue(response.body().string(), Map.class);
    System.out.println(result);
}

csharp

using System.Net.Http;
using System.Net.Http.Json;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var payload = JsonSerializer.Deserialize<object>("{ \"token\": \"example\", \"maxRepos\": 3, \"username\": \"torvalds\" }");
var response = await client.PostAsJsonAsync("https://api.upapi.io/github-user-emails.get", payload);

var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(result);

Frequently asked questions

How much does the Get GitHub User Commit Emails API cost per call?

Each call spends 3 weighted units of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.

How do I authenticate to the Get GitHub User Commit Emails API?

Send your key in the X-Api-Key header. A free guest key is available without creating an account.

Are Get GitHub User Commit Emails API responses cached?

Yes — identical requests are served from cache for 600 seconds, and a cache hit is not billed.

More Developer Tools APIs

Get GitHub User List GitHub Issue Comments List GitHub Repository Contributors List GitHub Repository Issues Search GitHub Discussions Search GitHub Issues Search GitHub Repositories Search GitHub Users

Browse every Developer Tools API →