datasets_github_users_facets
Get aggregated GitHub user counts grouped by selected facets — country, company, activity, influence tier and more — with optional filters to refine the analysis.
Instructions
Facet the GitHub users dataset. Returns terms aggregation counts for the GitHub users dataset. Facet enum: influence_tier, type, country, country_code, state, city, domains, company, reachable, has_email, has_twitter, has_blog, active_90d, hireable, is_org, is_bot, is_suspected_automation. influence_tier enum: nano, micro, mid, macro, mega. Suspected-automation records are excluded by default unless is_suspected_automation is set.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Full-text query over login, name, company, bio and location, max 256 characters | |
| lat | No | Latitude for radius filtering | |
| lon | No | Longitude for radius filtering | |
| city | No | Exact geocoded city filter, max 128 characters | |
| sort | No | Sort enum: relevance, rank_score_desc, followers_desc, account_age_desc, account_age_asc, distance_asc | |
| facet | Yes | Facet enum: influence_tier, type, country, country_code, state, city, domains, company, reachable, has_email, has_twitter, has_blog, active_90d, hireable, is_org, is_bot, is_suspected_automation | |
| login | No | Exact login filter, max 128 characters | |
| state | No | Exact geocoded state filter, max 128 characters | |
| domain | No | Interest-domain tag filter, max 128 characters | |
| is_bot | No | Bot filter | |
| is_org | No | Organization filter | |
| company | No | Exact normalized-company filter, max 128 characters | |
| country | No | Exact geocoded country filter, max 128 characters | |
| has_blog | No | Filter by public blog/website presence | |
| hireable | No | Filter by the GitHub available-for-hire flag | |
| radius_m | No | Radius in meters, 1 through 50000; requires lat and lon when supplied | |
| has_email | No | Filter by public email presence | |
| min_repos | No | Minimum public repository count | |
| reachable | No | Filter by any public contact channel | |
| active_90d | No | Filter by activity within the last 90 days | |
| has_twitter | No | Filter by public Twitter/X handle presence | |
| country_code | No | Exact ISO country-code filter, max 128 characters | |
| max_followers | No | Maximum follower count | |
| min_followers | No | Minimum follower count | |
| influence_tier | No | Follower-tier enum: nano, micro, mid, macro, mega | |
| min_rank_score | No | Minimum composite rank score | |
| max_account_age_years | No | Maximum account age in years | |
| min_account_age_years | No | Minimum account age in years | |
| is_suspected_automation | No | Suspected automation filter; omitted these are hidden by default |