# GitHub Email & Lead Enricher — Devs to CRM Leads | Official API (`bovi/github-profile-email-enricher`) Actor Turn GitHub users, orgs, repos or a search into enriched developer leads: email + company + location + hireable + followers + socials. Official API, no key required. - **URL**: https://apify.com/bovi/github-profile-email-enricher.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** Lead generation, Developer tools - **Stats:** 4 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.75 / 1,000 github leads This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## GitHub Email & Lead Enricher Turn GitHub identifiers into **enriched developer leads** — not just an email, the whole lead record a sales/recruiting workflow needs. ### What it does Give it any mix of: - **usernames** — GitHub logins to enrich directly - **orgs** — enrich every public member of an organization - **repos** (`owner/repo`) — enrich a project's contributors - **searchQuery** — GitHub user-search, enrich the matches …and for each developer it returns: | field | notes | |---|---| | `email` + `email_source` | profile email, or **recovered from public commits** when hidden (`profile` / `commit` / `none`) | | `company`, `location`, `bio`, `blog`, `twitter_username` | firmographic + contact context | | `hireable` | explicit "open to work" signal | | `followers`, `following`, `public_repos`, `public_gists` | lead-scoring metrics | | `account_created_at`, `profile_updated_at`, `html_url` | recency + navigation | | `parse_confidence`, `warnings` | a trust signal on each row (low = thin record) | ### The wedge Email-only competitors stop at `{email, login, name}`. This actor adds the **company / location / hireable / socials / scoring** fields that make a row an actual *lead* — and recovers the email from public commit history when the profile hides it. ### Access & cost Official GitHub REST API — no key required. Supply a free `githubToken` to raise the rate limit to 5000 req/hr; without one the actor rotates Apify Residential proxy IPs to stay under the anonymous per-IP limit. **Pay per lead** (`github-lead` event). > **What "per lead" means for billing:** you're charged once per person record > returned — *including* leads where no public email could be recovered. Those > records still carry name, company, location, bio, hireable, followers, and > socials (a usable CRM lead), so they're billed the same. On a typical run > roughly half to two-thirds of leads include an email; the rest are email-less > but enriched. To keep only rows with an email, filter on `email != null` > downstream. ### Notes - Orgs are skipped from the output — leads are people, not organizations. - Email recovery excludes GitHub's privacy `…@users.noreply.github.com` addresses. - All data is public; respect applicable laws when contacting leads. # Actor input Schema ## `usernames` (type: `array`): GitHub logins to enrich directly. Examples: ['torvalds', 'gvanrossum']. Each becomes one enriched lead. ## `orgs` (type: `array`): GitHub org logins — every PUBLIC member of each org is enriched. Example: ['apify', 'huggingface']. Great for sourcing leads from a company's open-source team. ## `repos` (type: `array`): Repositories whose CONTRIBUTORS you want as leads. Format 'owner/repo'. Example: ['apify/crawlee', 'psf/requests']. Reach the developers behind a project. ## `searchQuery` (type: `string`): GitHub user-search query — matching users are enriched. Supports GitHub search syntax: 'location:berlin language:python', 'fullstack followers:>500'. ## `maxResults` (type: `integer`): Maximum total enriched leads across all inputs. Default 100. ## `enrichEmailFromCommits` (type: `boolean`): When a user hides their profile email (most do), mine their public commit history for the email they push with. Excludes GitHub's privacy noreply addresses. Adds ~1 API call per user. Recommended ON. ## `githubToken` (type: `string`): Optional personal access token (generate free at github.com/settings/tokens — no scopes needed for public data). Raises the rate limit to 5000 req/hr. Without it the actor rotates Apify proxy IPs to stay within the anonymous limit. ## `proxyConfiguration` (type: `object`): Apify proxy. Defaults to Residential — keep it on so requests rotate IPs and never hit GitHub from a single address. ## Actor input object example ```json { "usernames": [ "torvalds", "gvanrossum" ], "maxResults": 100, "enrichEmailFromCommits": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ```` # Actor output Schema ## `results` (type: `string`): Dataset of enriched developer leads (login, name, email, email\_source, company, location, hireable, followers, public\_repos, twitter\_username, html\_url, parse\_confidence). # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "usernames": [ "torvalds", "gvanrossum" ], "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("bovi/github-profile-email-enricher").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "usernames": [ "torvalds", "gvanrossum", ], "maxResults": 100, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("bovi/github-profile-email-enricher").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "usernames": [ "torvalds", "gvanrossum" ], "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call bovi/github-profile-email-enricher --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/github-profile-email-enricher", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "GitHub Email & Lead Enricher — Devs to CRM Leads | Official API", "description": "Turn GitHub users, orgs, repos or a search into enriched developer leads: email + company + location + hireable + followers + socials. Official API, no key required.", "version": "0.1", "x-build-id": "Q9Gekhjogim4zqNp0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~github-profile-email-enricher/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-github-profile-email-enricher", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/bovi~github-profile-email-enricher/runs": { "post": { "operationId": "runs-sync-bovi-github-profile-email-enricher", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/bovi~github-profile-email-enricher/run-sync": { "post": { "operationId": "run-sync-bovi-github-profile-email-enricher", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "usernames": { "title": "GitHub usernames", "type": "array", "description": "GitHub logins to enrich directly. Examples: ['torvalds', 'gvanrossum']. Each becomes one enriched lead.", "items": { "type": "string" } }, "orgs": { "title": "Organizations", "type": "array", "description": "GitHub org logins — every PUBLIC member of each org is enriched. Example: ['apify', 'huggingface']. Great for sourcing leads from a company's open-source team.", "items": { "type": "string" } }, "repos": { "title": "Repositories (owner/repo)", "type": "array", "description": "Repositories whose CONTRIBUTORS you want as leads. Format 'owner/repo'. Example: ['apify/crawlee', 'psf/requests']. Reach the developers behind a project.", "items": { "type": "string" } }, "searchQuery": { "title": "User search query", "type": "string", "description": "GitHub user-search query — matching users are enriched. Supports GitHub search syntax: 'location:berlin language:python', 'fullstack followers:>500'." }, "maxResults": { "title": "Max leads", "minimum": 1, "type": "integer", "description": "Maximum total enriched leads across all inputs. Default 100." }, "enrichEmailFromCommits": { "title": "Recover email from public commits", "type": "boolean", "description": "When a user hides their profile email (most do), mine their public commit history for the email they push with. Excludes GitHub's privacy noreply addresses. Adds ~1 API call per user. Recommended ON.", "default": true }, "githubToken": { "title": "GitHub token (optional)", "type": "string", "description": "Optional personal access token (generate free at github.com/settings/tokens — no scopes needed for public data). Raises the rate limit to 5000 req/hr. Without it the actor rotates Apify proxy IPs to stay within the anonymous limit." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify proxy. Defaults to Residential — keep it on so requests rotate IPs and never hit GitHub from a single address.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```