# API Enrichment (`springboltx/api-enrichment`) Actor One endpoint, full contact records. Submit any partial input: name, email, LinkedIn URL, company, or any combination, and Enrichment returns a complete profile: verified email, mobile phone, title, seniority, company, industry, size, and location. - **URL**: https://apify.com/springboltx/api-enrichment.md - **Developed by:** [Springbolt X](https://apify.com/springboltx) (community) - **Categories:** Lead generation - **Stats:** 4 total users, 3 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $100.00 / 1,000 enrichment results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ### Append phone, email, title, company, and firmographic attributes to partial records. Turn fragments into full contact profiles One endpoint, full contact records. Submit any partial input: name, email, LinkedIn URL, company, or any combination, and Enrichment returns a complete profile: verified email, mobile phone, title, seniority, company, industry, size, and location. Cleans dirty CRM data, completes form-fill leads, and powers personalized outreach at scale. ### Input Parameters | Field | Type | Description | |-------|------|-------------| | `first_name` | String | The person's first name. It doesn't need to be in lowercase. | | `last_name` | String | The person's last name. It doesn't need to be in lowercase. | | `email` | String | The person's email address. This can be a work or personal email address. | | `phone` | String | The person's phone number, which can be a mobile or landline number.| | `linkedin_url` | String | The person's LinkedIn profile URL. | | `company_name` | String | The company name from which you want to find the lead. For example, "google". Note that providing the domain name gives better results as it removes the conversion from the company name. The company name doesn't need to be in lowercase. | | `job_title` | String | The person's job title. | At least one field is required. ### Input Sample ```json { "first_name": "John", "last_name": "Doe", "email": "john@acme.com", "phone": "+11234567890", "linkedin_url": "https://www.linkedin.com/in/john-doe", "company_name": "Acme Inc", "job_title": "VP Sales" } ```` ### Output Sample ```json { "success": true, "message": "Resolution successfully completed!", "lead": { "name_first": "John", "name_last": "Doe", "linkedin_url": "linkedin.com/in/john-doe", "email_work": { "email": "john.doe@acme.com", "validity": "valid" }, "email_personal": { "email": "johndoe@gmail.com", "validity": "valid" }, "email_alt": null, "emails_hashed": [], "phone": { "number": "+15125550147", "line_type": "mobile", "validity": "valid" }, "phone_alt": null, "job_title": "VP Sales", "job_seniority": "VP", "job_department": "Sales", "company": { "name": "Acme Inc", "domain": "acme.com", "linkedin_url": "linkedin.com/company/acme-inc", "industry": "Technology", "revenue": "$50M - $100M", "employee_count": "201 - 500", "year_founded": "2015", "address": { "street": "100 Congress Ave", "zip_code": "73301", "city": "Austin", "state": "Texas" }, "logo": "https://example.com/logo.jpg", "about": "Acme Inc is a B2B SaaS platform." }, "address": { "street": "200 Main St", "zip_code": "73301", "city": "Austin", "state": "Texas" } }, "payload": { "first_name": "John", "last_name": "Doe", "email": "john@acme.com", "phone": "+11234567890", "linkedin_url": "https://www.linkedin.com/in/john-doe", "company_name": "Acme Inc", "job_title": "VP Sales" } } ``` ### About [Springbolt X](springboltx.com) is a data intelligence platform offering APIs for lead enrichment, deanonymization, IP resolution, LinkedIn data, and more. # Actor input Schema ## `first_name` (type: `string`): Lead's first name. ## `last_name` (type: `string`): Lead's last name. ## `email` (type: `string`): Lead's email address. ## `phone` (type: `string`): Lead's phone number. ## `linkedin_url` (type: `string`): Lead's LinkedIn profile URL. ## `company_name` (type: `string`): Lead's company name. ## `job_title` (type: `string`): Lead's job title. ## Actor input object example ```json { "first_name": "John", "last_name": "Doe", "email": "john@acme.com", "phone": "+11234567890", "linkedin_url": "https://www.linkedin.com/in/john-doe", "company_name": "Acme Inc", "job_title": "VP Sales" } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "first_name": "John", "last_name": "Doe", "email": "john@acme.com", "phone": "+11234567890", "linkedin_url": "https://www.linkedin.com/in/john-doe", "company_name": "Acme Inc", "job_title": "VP Sales" }; // Run the Actor and wait for it to finish const run = await client.actor("springboltx/api-enrichment").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 = { "first_name": "John", "last_name": "Doe", "email": "john@acme.com", "phone": "+11234567890", "linkedin_url": "https://www.linkedin.com/in/john-doe", "company_name": "Acme Inc", "job_title": "VP Sales", } # Run the Actor and wait for it to finish run = client.actor("springboltx/api-enrichment").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 '{ "first_name": "John", "last_name": "Doe", "email": "john@acme.com", "phone": "+11234567890", "linkedin_url": "https://www.linkedin.com/in/john-doe", "company_name": "Acme Inc", "job_title": "VP Sales" }' | apify call springboltx/api-enrichment --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=springboltx/api-enrichment", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "API Enrichment", "description": "One endpoint, full contact records. Submit any partial input: name, email, LinkedIn URL, company, or any combination, and Enrichment returns a complete profile: verified email, mobile phone, title, seniority, company, industry, size, and location.", "version": "0.0", "x-build-id": "o7rMEl1npn5RYXT0l" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/springboltx~api-enrichment/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-springboltx-api-enrichment", "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/springboltx~api-enrichment/runs": { "post": { "operationId": "runs-sync-springboltx-api-enrichment", "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/springboltx~api-enrichment/run-sync": { "post": { "operationId": "run-sync-springboltx-api-enrichment", "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": { "first_name": { "title": "First Name", "type": "string", "description": "Lead's first name." }, "last_name": { "title": "Last Name", "type": "string", "description": "Lead's last name." }, "email": { "title": "Email", "type": "string", "description": "Lead's email address." }, "phone": { "title": "Phone", "type": "string", "description": "Lead's phone number." }, "linkedin_url": { "title": "LinkedIn URL", "type": "string", "description": "Lead's LinkedIn profile URL." }, "company_name": { "title": "Company Name", "type": "string", "description": "Lead's company name." }, "job_title": { "title": "Job Title", "type": "string", "description": "Lead's job title." } } }, "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 } } } } } } } } } } ```