Airtable Lead Enricher
Pricing
Pay per usage
Stop manual lead research. This actor enriches your Airtable leads with contact data and AI scores, then updates your base.
Pricing
Pay per usage
Rating
0.0
(0)
Developer
DataHQ
Actor stats
0
Bookmarked
1
Total users
0
Monthly active users
2 months ago
Last modified
Categories
Share
You can access the Airtable Lead Enricher programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.0", "x-build-id": "iUTEsVLfFnxb8R0hf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datahq~airtable-lead-enricher/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datahq-airtable-lead-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/datahq~airtable-lead-enricher/runs": { "post": { "operationId": "runs-sync-datahq-airtable-lead-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/datahq~airtable-lead-enricher/run-sync": { "post": { "operationId": "run-sync-datahq-airtable-lead-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": { "airtable": { "title": "Airtable Configuration", "type": "object", "description": "Configure connection to your Airtable base", "properties": { "apiKey": { "title": "Airtable API Key", "type": "string", "description": "Personal Access Token from Airtable (https://airtable.com/create/tokens). Required scopes: data.records:read, data.records:write", "editor": "textfield" }, "pat": { "title": "Airtable Personal Access Token (Alternative)", "type": "string", "description": "Alternative to apiKey field. Use this when calling via API to avoid Apify auto-redaction.", "editor": "textfield" }, "baseId": { "title": "Base ID", "type": "string", "description": "Your Airtable base ID (starts with 'app'). Find it in your base URL: airtable.com/appXXXXXXXXXXXXXX", "pattern": "^app[a-zA-Z0-9]+$", "editor": "textfield" }, "tableId": { "title": "Table ID", "type": "string", "description": "Table ID (starts with 'tbl'). Find it by clicking the table dropdown > 'Copy table ID'", "pattern": "^tbl[a-zA-Z0-9]+$", "editor": "textfield" }, "viewId": { "title": "View ID (Optional)", "type": "string", "description": "Limit to specific view (starts with 'viw'). Leave empty to process all records in the table.", "editor": "textfield" }, "filterFormula": { "title": "Filter Formula (Optional)", "type": "string", "description": "Airtable formula to filter records. Example: AND({Status} = 'New Lead', {Email} = BLANK())", "editor": "textarea", "example": "AND({Status} = 'New Lead', {Email} = BLANK())" }, "maxRecords": { "title": "Max Records to Process", "type": "integer", "default": 100, "minimum": 1, "maximum": 100, "description": "Maximum number of records to enrich in this run (hard limit: 100)" }, "inputFields": { "title": "Field Mapping (Input)", "type": "object", "description": "Map your Airtable field names to enricher inputs. At minimum, provide 'companyName'.", "editor": "json", "example": { "companyName": "Company Name", "website": "Website", "location": "HQ Location" } }, "outputFields": { "title": "Field Mapping (Output - Optional)", "type": "object", "description": "Map enriched data to your Airtable fields. If not provided, default field names will be used (email, phone, leadScore, etc.).", "editor": "json", "example": { "email": "Contact Email", "phone": "Phone Number", "leadScore": "Lead Score", "summary": "Company Summary", "techStack": "Tech Stack", "icpScore": "ICP Match Score" } }, "updateMode": { "title": "Update Mode", "type": "string", "enum": [ "append", "overwrite", "skip" ], "default": "append", "description": "How to handle existing data in Airtable", "enumTitles": [ "Append (fill empty fields only)", "Overwrite (replace all fields)", "Skip (skip record if any field exists)" ] } } }, "mode": { "title": "Processing Mode", "enum": [ "batch", "single", "api" ], "type": "string", "description": "How to process input data", "default": "batch" }, "recordIds": { "title": "Record IDs (Single mode only)", "type": "array", "description": "Specific record IDs to enrich when mode='single'. Find record IDs in Airtable: Right-click record > Copy record URL, ID is the recXXXXXXXXXXXXXX part.", "items": { "type": "string", "pattern": "^rec[a-zA-Z0-9]+$" } }, "companies": { "title": "Companies (API mode only)", "maxItems": 1000, "type": "array", "description": "Direct JSON array of companies to enrich when mode='api'. No Airtable connection needed. Results written to Actor dataset. Maximum 1000 companies per run.", "items": { "type": "object", "properties": { "companyName": { "title": "Company Name", "type": "string", "description": "Company name (required)" }, "website": { "title": "Website", "type": "string", "description": "Company website URL (optional)" }, "location": { "title": "Location", "type": "string", "description": "Company location/city (optional)" } }, "required": [ "companyName" ] } }, "webhookUrl": { "title": "Webhook URL (Optional)", "pattern": "^https?://.*", "type": "string", "description": "POST enrichment results to this URL on completion. Useful for triggering workflows (n8n, Make, Zapier)." }, "dryRun": { "title": "Dry Run", "type": "boolean", "description": "Preview enrichment results without writing to Airtable. Results available in Actor dataset.", "default": false }, "enrichment": { "title": "Enrichment Sources", "type": "object", "description": "Configure which data sources to use for enrichment", "properties": { "sources": { "title": "Enabled Sources", "type": "array", "description": "Select which enrichment sources to use. Recommended: google_maps + website + hunter for best results.", "editor": "select", "items": { "type": "string", "enum": [ "google_maps", "website", "hunter" ] }, "uniqueItems": true, "default": [ "google_maps", "website" ] }, "concurrency": { "title": "Concurrent Enrichments", "type": "integer", "description": "Number of records to process in parallel (1-20). Higher = faster but more memory.", "default": 10, "minimum": 1, "maximum": 20 }, "timeout": { "title": "Enrichment Timeout (seconds)", "type": "integer", "description": "Maximum time per enrichment source. Increase for slow websites.", "default": 30, "minimum": 10, "maximum": 120 }, "googleMaps": { "title": "Google Maps Settings", "type": "object", "description": "Google Maps enrichment configuration", "properties": { "enabled": { "title": "Enable Google Maps", "type": "boolean", "default": true, "description": "Extract business info from Google Maps (email, phone, address, rating, reviews)" }, "includeReviews": { "title": "Include Reviews", "type": "boolean", "default": false, "description": "Extract review text (slower, more expensive, may hit rate limits)" } } }, "website": { "title": "Website Crawler Settings", "type": "object", "description": "Website enrichment configuration", "properties": { "enabled": { "title": "Enable Website Crawling", "type": "boolean", "default": true, "description": "Crawl company website for contact info, tech stack, company description" }, "crawlDepth": { "title": "Crawl Depth", "type": "integer", "minimum": 1, "maximum": 3, "default": 2, "description": "How many link levels deep to crawl (1=homepage only, 2=homepage+subpages, 3=deep crawl)" } } }, "hunter": { "title": "Hunter.io Settings (BYOK)", "type": "object", "description": "Hunter.io domain email search configuration. Requires Hunter.io API key (https://hunter.io/api). Pay Hunter.io directly.", "properties": { "enabled": { "title": "Enable Hunter.io", "type": "boolean", "default": false, "description": "Use Hunter.io to find verified emails, social profiles, and company data from domain" }, "apiKey": { "title": "Hunter.io API Key", "type": "string", "description": "Your Hunter.io API key. Get it from: https://hunter.io/api", "editor": "textfield" } } } } }, "scoring": { "title": "Lead Scoring", "type": "object", "description": "Configure AI-powered lead scoring and ICP matching", "properties": { "enabled": { "title": "Enable Lead Scoring", "type": "boolean", "default": true, "description": "Calculate lead scores with quality labels (Excellent, Good, Fair, Poor, Bad) based on data quality and ICP match" }, "icpCriteria": { "title": "Ideal Customer Profile (ICP) Criteria", "type": "string", "description": "Describe your ideal customer in natural language. Be specific about industry, size, location, tech stack, etc. The AI will score leads based on how well they match this profile.", "editor": "textarea", "example": "B2B SaaS companies with 10-500 employees, US-based, strong online presence, using modern tech stack (React, Node.js), good customer reviews" }, "weights": { "title": "Custom Scoring Weights", "type": "object", "description": "Adjust importance of each signal (must sum to 100). Leave empty to use default weights.", "editor": "json", "example": { "hasEmail": 20, "hasPhone": 15, "socialPresence": 15, "reviewScore": 10, "icpMatch": 40 } }, "minimumConfidence": { "title": "Minimum Confidence Threshold", "type": "number", "description": "Minimum data confidence (0-1) to include enriched data. Lower = more data but less reliable.", "default": 0.3, "minimum": 0, "maximum": 1 } } }, "llm": { "title": "LLM Provider (BYOK - Bring Your Own Key)", "type": "object", "description": "Bring your own LLM API key for AI-powered scoring and summaries. You pay your provider directly (~$0.001 per lead).", "properties": { "enabled": { "title": "Enable LLM", "type": "boolean", "default": true, "description": "Use AI for ICP scoring and company summaries. Highly recommended for best results." }, "provider": { "title": "Provider", "type": "string", "enum": [ "anthropic", "openai", "bedrock" ], "default": "openai", "description": "Choose your LLM provider", "enumTitles": [ "Anthropic Claude (Most accurate)", "OpenAI GPT (Fast & cheap)", "AWS Bedrock (Enterprise)" ] }, "model": { "title": "Model (Optional)", "type": "string", "description": "Override default model. Defaults: Claude Haiku 4.5 (Anthropic), GPT-4o (OpenAI), Claude Haiku 4.5 (Bedrock). Leave empty for recommended default.", "editor": "textfield", "prefill": "" }, "apiKey": { "title": "API Key", "type": "string", "description": "Your LLM provider API key (required for Anthropic/OpenAI, optional for Bedrock if using AWS IAM). Get keys from: Anthropic Console, OpenAI Platform, or AWS Console.", "editor": "textfield" }, "region": { "title": "AWS Region (Bedrock only)", "type": "string", "description": "AWS region for Bedrock (e.g., us-east-1, us-west-2). Only used when provider=bedrock.", "default": "us-east-1", "editor": "textfield" }, "awsAccessKeyId": { "title": "AWS Access Key ID (Bedrock only)", "type": "string", "description": "Optional: AWS Access Key ID for Bedrock. If not provided, uses default AWS credential chain (env vars, IAM role, etc.).", "editor": "textfield" }, "awsSecretAccessKey": { "title": "AWS Secret Access Key (Bedrock only)", "type": "string", "description": "Optional: AWS Secret Access Key for Bedrock. Required if awsAccessKeyId is provided.", "editor": "textfield" }, "maxTokens": { "title": "Max Tokens", "type": "integer", "description": "Maximum tokens for LLM responses. Higher = more detailed summaries but more expensive.", "default": 1000, "minimum": 100, "maximum": 4000 }, "temperature": { "title": "Temperature", "type": "number", "description": "LLM creativity (0 = deterministic/factual, 1 = creative/varied). Recommended: 0.3 for lead scoring.", "default": 0.3, "minimum": 0, "maximum": 1 } } } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Airtable Lead Enricher from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: