GitHub public activity API
The profile's contribution activity timeline (commits, repositories created, pull requests, issues, reviews), one month a page, newest month first, paging backward through the year.
100 free credits. No card needed.
gaearon, 2025
Sent with a handle and the year
- Cost
- 1 credit
- Fields
- 8
- Paging
- Cursor
The first results of a page
What you get for each event
What you can build with it
What a developer did each month. Each page is one month of the activity timeline: commits, new repositories, pull requests, issues and reviews. For June 2025 the sample shows gaearon with 23 commits in 3 repositories.
- month
- June 2025
- summary
- Created 23 commits in 3...
- type
- commits
The projects someone contributes to. extra.details names each repository with its commit count, gaearon/overreacted.io with 21 and vercel/next.js with 1, so you see where a developer spends time beyond their own code.
- 1
- gaearon/overreacted.io 21 commits
- 2
- vercel/next.js 1 commit
- 3
- bluesky-social/social-app 1 commit
New repositories, with their language. A repositories entry names each new repository with its language and date: gaearon/analysis-solutions, in Lean, on Jun 28.
- repo
- gaearon/analysis-solutions
- language
- Lean
- date
- Jun 28
From a key to JSON.
handle (gaearon) and year (2025).cursor until has_more is false.The request. GET /v1/github/user/activity
curl -G "https://api.socialscrape.dev/v1/github/user/activity" \ -d handle=gaearon \ -d year=2025 \ -H "x-api-key: $SOCIALSCRAPE_API_KEY"
import requests r = requests.get( "https://api.socialscrape.dev/v1/github/user/activity", params={"handle": "gaearon", "year": "2025"}, headers={"x-api-key": KEY}, ) events = r.json()["data"]["items"]
const url = new URL("https://api.socialscrape.dev/v1/github/user/activity"); url.searchParams.set("handle", "gaearon"); url.searchParams.set("year", "2025"); const res = await fetch(url, { headers: { "x-api-key": KEY }, }); const { data } = await res.json();
The response. A sample, in the shape every call returns.
{
"ok": true,
"credits_charged": 1,
"data": {
"items": [
{
"type": "commits",
"actor": {
"handle": "gaearon",
"url": "https://github.com/gaearon"
}
},
...
],
"cursor": "eyJwIjo4fQ",
"has_more": true
}
}
Ask in plain words. Ask your agent for GitHub public activity in plain words, and the SocialScrape MCP server makes the call.
Get the public activity for gaearon.
Here are the first events.
One tool call
GitHub public activity, given a handle.
Same price as the API
1 credit a call; a repeat within 30 days is free.
Runs on your machine
Your key stays in your agent's settings.
Pay only for data you get.
Failed requests and cached repeats are free.
1,000 credits
$13 one time
Get an API key- $13.00 per 1,000 credits
- Credits never expire
- No subscription
25,000 credits
$55 one time
Get an API key- $2.20 per 1,000 credits
- Credits never expire
- No subscription
230,000 credits
$349 one time
Get an API key- $1.52 per 1,000 credits
- Credits never expire
- No subscription
Questions, answered.
Common questions
How do I page back through a GitHub user's year?
Pages go a month at a time, newest month first, through the year you ask for. The cursor in each answer opens the month before.
How is activity different from the contribution calendar?
GitHub contribution calendar gives a count per day. Activity says what the work was and where it went.
What does it return?
Each event has up to 8 fields, and the sample fills id, type and actor.
What do I send?
Send one of handle or url.
handle: A username (with or without @) or a profile or repository URL (github.com/<name>).
url: Profile URL (github.com/<user>).
year: Calendar year (2008 onward); default the current year. From 2008 to 2100.
Which errors can it return?
invalid_params, unsupported_url and not_found. None is charged, and the errors list says which to retry.
Is there an SDK call for it?
client.github.user_activity(...) in Python and client.github.userActivity() in TypeScript.
Start pulling social data.
100 free credits. No card needed.