Faro
Tools/contact-data
Contact Data

Contact Data

Active

Your agent has no account for B2B data; this returns verified business contacts plus email and phone checks.

3 tools

Real-time B2B data enrichment: enrich companies by domain, find contacts at target accounts, and verify emails and phone numbers.

Business & Companiesb2bdata enrichmentcompany datacontact enrichmentlead generationprospecting

Tools (3)

Contact Enrichment

▶contact_email_or_phone

Enrich a list of contacts with verified emails and phone numbers from a waterfall of 20+ data providers. Returns full contact records with triple-validated emails and high-coverage mobile numbers. Runs as a quick job; if the response comes back with a continuation_token, call again with only that token (do not ask the user) until the full contact records return.

Usage-based · 100 credits per verified email, 400 per verified phone number

Example prompts

  • “Find a verified work email for this LinkedIn profile”
  • “Get the email and phone number for a contact by name and company”
  • “Enrich these contacts with verified emails and phones”

Parameters

contactsarrayoptional

Up to 10 contacts: each either {linkedin_url, domain} or {firstname, lastname, domain}. Providing `domain` dramatically improves email accuracy for people with multiple affiliations (CEOs on boards, multi-company founders, etc.).

enrich_fieldsarrayoptional

Fields to enrich, e.g. ["contact.emails", "contact.phones"].

return_any_domainbooleanoptional

When true, allow enrichment of contacts without a domain, DataMerge will pick whichever current employer it considers primary. Default false: if any contact lacks `domain` the call returns status="domain_required" instead. Only set this when you genuinely don't know the contact's employer.

continuation_tokenstringoptional

Token from a prior pending response, when set, all other params are ignored.

API Usage

curl -X POST "https://skill.askfaro.com/skills/contact-data/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Find a verified work email for this LinkedIn profile"
  }
}'

CLI Usage

askfaro describe contact-data/run_contact_enrich

Install pip install askfaro-cli, then askfaro auth login.

Contact Search

▶contact_search

Search for contacts at a set of target company domains and get matching records back inline in a single call, with no polling step. Up to 10 domains per call and 10 results per company.

Usage-based · 50 credits per contact returned

Example prompts

  • “Find the CEO and VP of Sales at a company”
  • “List the decision-makers at a target account”
  • “Who are the engineering leaders at this company?”

Parameters

domainsarrayrequired

One company domain to search (e.g. stripe.com).

locationobjectoptional
job_titlesobjectoptional
max_results_per_companyintegeroptional

Max contacts to return (1–10).

API Usage

curl -X POST "https://skill.askfaro.com/skills/contact-data/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Find the CEO and VP of Sales at a company"
  }
}'

CLI Usage

askfaro describe contact-data/run_contact_search_unenriched

Install pip install askfaro-cli, then askfaro auth login.

Contact Search (Enriched)

▶contact_search_enriched

Find contacts at target company domains and get back fully enriched records with verified emails, phone numbers, titles, and other selected fields, in one call. Runs as a quick job; if the response comes back with a continuation_token, call again with only that token (do not ask the user) until the full contact records return.

Usage-based · 50 credits per contact found, plus 100 per email and 400 per phone enriched

Example prompts

  • “Find contacts at a company and get their verified emails and phones”
  • “Build an enriched contact list for a target account in one step”

Parameters

domainsarrayoptional

One company domain to search (e.g. stripe.com). Required on the first call; omit when using continuation_token.

locationobjectoptional
job_titlesobjectoptional
enrich_fieldsarrayoptional

At least one of "contact.emails" (~1 DM credit each) or "contact.phones" (~4 DM credits each). Required on the first call; omit when using continuation_token.

continuation_tokenstringoptional

Token from a prior pending response, when set, all other params are ignored.

max_results_per_companyintegeroptional

Max contacts to return (1–10).

API Usage

curl -X POST "https://skill.askfaro.com/skills/contact-data/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Find contacts at a company and get their verified emails and phones"
  }
}'

CLI Usage

askfaro describe contact-data/run_contact_search

Install pip install askfaro-cli, then askfaro auth login.

▶README

Contact Data

Real-time B2B contact data: find contacts at target accounts and verify their emails and phone numbers. (For company firmographics by domain, see the Company Data namespace.)

Tools

run_contact_enrich

Enrich up to 10 contacts with verified emails and phone numbers. Provide LinkedIn URLs or name+domain pairs. Specify enrich_fields to control which data is returned (and what you're charged for). Like company enrichment, supports continuation tokens for long-running jobs.

Pricing: charged per contact based on the fields returned. Email-only lookups cost less than email+phone.

run_contact_search_unenriched

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.

Pricing: charged per contact returned.

Example prompts

  • "Find the CEO and VP of Sales at acme.com"
  • "Enrich this LinkedIn profile with their work email: linkedin.com/in/johndoe"
  • "Who are the engineering leaders at openai.com?"