DataMerge
Activeby Faro
Real-time B2B data enrichment: enrich companies by domain, find contacts at target accounts, and verify emails and phone numbers.
Tools (4)
Company Enrichment
Usage-based · Variable cost based on enrichment depth. Max ≈ 800 credits (≈ $0.80) per call. Final charge is computed from actual usage on success.Agent-friendly company enrichment. On the first call provide enrichment params (domain, domains, company_name, country_code, etc.); the server starts the job and polls internally for up to ~25s. If the job is still running, the response will be {status:"pending", continuation_token, attempt, elapsed_seconds}. When you see status "pending" you MUST immediately call run_company_enrichment again with only continuation_token set — do not ask the user, do not call any other tool first. Typical jobs f
Usage-based · Variable cost based on enrichment depth. Max ≈ 800 credits (≈ $0.80) per call. Final charge is computed from actual usage on success.
Agent-friendly company enrichment. On the first call provide enrichment params (domain, domains, company_name, country_code, etc.); the server starts the job and polls internally for up to ~25s. If the job is still running, the response will be {status:"pending", continuation_token, attempt, elapsed_seconds}. When you see status "pending" you MUST immediately call run_company_enrichment again with only continuation_token set — do not ask the user, do not call any other tool first. Typical jobs f
Example prompts
- “Get firmographics (employees, industry, HQ) for a company by domain”
- “Enrich a list of company domains with size, industry, and country”
- “Look up B2B company data by website for lead scoring”
- “Find the global ultimate parent for a subsidiary's domain”
Parameters
Single company domain (e.g. stripe.com).
Up to 10 company domains for batch enrichment.
ISO 2-letter country code to improve matching.
Return the global ultimate parent company.
Token from a prior pending response — when set, all other params are ignored.
API Usage
curl -X POST "https://api.askfaro.com/invoke/datamerge/run_company_enrichment" \
-H "Authorization: Bearer <your_api_key>" \
-H "Content-Type: application/json" \
-d '{
"arguments": {}
}'CLI Usage
faro invoke datamerge/run_company_enrichment --params '{}'Install pip install askfaro-cli, then faro auth login.
Contact Email & Phone
Usage-based · Variable cost based on contacts matched. Max ≈ 5,000 credits (≈ $5.00) per call. Final charge is computed from actual usage on success.Agent-friendly contact enrichment. On the first call provide contacts and enrich_fields; the server starts the job and polls internally for up to ~25s. If still running, returns {status:"pending", continuation_token, attempt, elapsed_seconds} — you MUST immediately call run_contact_enrich again with only continuation_token set. Do not ask the user. Typical jobs finish within 5 attempts. On completion the response contains record_ids and full contact records.
Usage-based · Variable cost based on contacts matched. Max ≈ 5,000 credits (≈ $5.00) per call. Final charge is computed from actual usage on success.
Agent-friendly contact enrichment. On the first call provide contacts and enrich_fields; the server starts the job and polls internally for up to ~25s. If still running, returns {status:"pending", continuation_token, attempt, elapsed_seconds} — you MUST immediately call run_contact_enrich again with only continuation_token set. Do not ask the user. Typical jobs finish within 5 attempts. On completion the response contains record_ids and full contact records.
Example prompts
- “Find verified work emails for a list of contacts”
- “Append phone numbers to a list of B2B prospects”
- “Verify email addresses for a sales outreach list”
- “Get direct-dial phone numbers for sales leads”
Parameters
Up to 10 contacts: each either {linkedin_url, domain} or {firstname, lastname, domain}. Providing domain dramatically improves email accuracy for people with multiple affiliations.
Fields to enrich, e.g. [contact.emails, contact.phones].
When true, allow enrichment of contacts without a domain — DataMerge picks whichever current employer it considers primary. Default false: if any contact lacks domain the call returns status=domain_required.
Token from a prior pending response — when set, all other params are ignored.
API Usage
curl -X POST "https://api.askfaro.com/invoke/datamerge/run_contact_enrich" \
-H "Authorization: Bearer <your_api_key>" \
-H "Content-Type: application/json" \
-d '{
"arguments": {}
}'CLI Usage
faro invoke datamerge/run_contact_enrich --params '{}'Install pip install askfaro-cli, then faro auth login.
Contact Search
Usage-based · Variable cost based on contacts returned. Max ≈ 500 credits (≈ $0.50) per call. Final charge is computed from actual usage on success.POST /v1/contact/search/unenriched/sync. Synchronous unenriched contact search — returns contacts inline (no polling). Requires the `contact_search_unenriched` beta flag. Limits: 10 domains and max_results_per_company ≤ 10. Response includes credits_consumed_total computed as 0.5 × len(contacts).
Usage-based · Variable cost based on contacts returned. Max ≈ 500 credits (≈ $0.50) per call. Final charge is computed from actual usage on success.
POST /v1/contact/search/unenriched/sync. Synchronous unenriched contact search — returns contacts inline (no polling). Requires the `contact_search_unenriched` beta flag. Limits: 10 domains and max_results_per_company ≤ 10. Response includes credits_consumed_total computed as 0.5 × len(contacts).
Example prompts
- “List contacts with the title 'Head of Engineering' at these companies”
- “Find marketing decision-makers at a list of target accounts”
- “Search for contacts by job title and location across a set of domains”
Parameters
One company domain to search (e.g. stripe.com).
Max contacts to return (1–10).
API Usage
curl -X POST "https://api.askfaro.com/invoke/datamerge/run_contact_search_unenriched" \
-H "Authorization: Bearer <your_api_key>" \
-H "Content-Type: application/json" \
-d '{
"arguments": {
"domains": []
}
}'CLI Usage
faro invoke datamerge/run_contact_search_unenriched --params '{"domains":[]}'Install pip install askfaro-cli, then faro auth login.
Contact Search (Enriched)
Usage-based · Variable cost based on contacts returned and enrichments. Max ≈ 5,000 credits (≈ $5.00) per call. Final charge is computed from actual usage on success.Agent-friendly contact search. On the first call provide domains and enrich_fields; the server starts the job and polls internally for up to ~25s. If still running, returns {status:"pending", continuation_token, attempt, elapsed_seconds} — you MUST immediately call run_contact_search again with only continuation_token set. Do not ask the user. On completion the response contains record_ids, full contact records, and credits_consumed_total.
Usage-based · Variable cost based on contacts returned and enrichments. Max ≈ 5,000 credits (≈ $5.00) per call. Final charge is computed from actual usage on success.
Agent-friendly contact search. On the first call provide domains and enrich_fields; the server starts the job and polls internally for up to ~25s. If still running, returns {status:"pending", continuation_token, attempt, elapsed_seconds} — you MUST immediately call run_contact_search again with only continuation_token set. Do not ask the user. On completion the response contains record_ids, full contact records, and credits_consumed_total.
Example prompts
- “Find VPs of Engineering at these target accounts and return their emails”
- “Build an outbound list: titles + companies → name, email, phone”
- “Search and enrich B2B contacts (email + phone) in a single call”
Parameters
One company domain to search (e.g. stripe.com). Required on the first call; omit when using continuation_token.
At least one of contact.emails (~1 DM credit each) or contact.phones (~4 DM credits each). Required on first call; omit on continuation.
Token from a prior pending response — when set, all other params are ignored.
Max contacts to return (1–10).
API Usage
curl -X POST "https://api.askfaro.com/invoke/datamerge/run_contact_search" \
-H "Authorization: Bearer <your_api_key>" \
-H "Content-Type: application/json" \
-d '{
"arguments": {}
}'CLI Usage
faro invoke datamerge/run_contact_search --params '{}'Install pip install askfaro-cli, then faro auth login.
▶README
DataMerge
DataMerge provides real-time B2B data enrichment — enrich companies by domain, find contacts at target accounts, and verify emails and phone numbers.
Tools
company_enrichment
Enrich up to 10 companies by domain in a single call. Returns firmographic data: industry, headcount, revenue range, founding year, tech stack, address, and more. Long-running jobs return a continuation_token — call again with only the token to resume.
contact_email_or_phone
Enrich up to 10 known contacts with verified emails and phone numbers. Provide LinkedIn URL or firstname+lastname, always alongside a company domain for best accuracy. If you don't know the domain, set return_any_domain=true to let DataMerge pick the primary employer. Specify enrich_fields to control which data is returned (and what you're charged for).
contact_search
Find contacts at a single target company without running email or phone enrichment. Returns names, job titles, and LinkedIn URLs. Up to 10 contacts per call. Use this to build a shortlist before deciding which contacts to fully enrich.
contact_search_enriched
Find contacts at a single target company AND enrich them with verified emails and phone numbers in one call. Up to 10 contacts per call. More expensive than contact_search — use when you want a one-shot list ready to outreach.
Example prompts
- "Enrich stripe.com and give me their tech stack and headcount"
- "Find me the CEO and VP of Sales at acme.com with their emails"
- "Enrich this LinkedIn profile with their work email: linkedin.com/in/johndoe (domain stripe.com)"
- "Who are the engineering leaders at openai.com?"