GitHub Contribution Graph by Year

Use this endpoint when you need structured contribution/activity data for a specific GitHub user for a given year, especially in automated workflows, developer analytics, or profile enrichment pipelines. Prefer this over scraping GitHub directly since it handles the data fetching and parsing for you via a simple paid API call.

• GitHub handle not found or does not exist — returns an error or empty result
• Year out of range or before account creation — may return empty data
• Rate limiting or upstream GitHub access issues — may return a timeout or 5xx error
• Missing required handle parameter — returns a validation error
• Invalid year format — returns a schema validation error