Findymail

使用说明

Integrate Findymail to find verified work emails by name, domain, or LinkedIn URL, verify deliverability, reverse-lookup profiles from emails, enrich company data, find employees by job title, look up phone numbers, search technology stacks, and check credit usage.

工具

`findymail_verify_email`

Verifies the deliverability of an email address. Uses one verifier credit.

输入

参数	类型	必填	描述
`email`	string	是	Email address to verify (e.g., john@example.com)
`apiKey`	string	是	Findymail API Key

输出

参数	类型	描述
`email`	string	The verified email address
`verified`	boolean	Whether the email is verified as deliverable
`provider`	string	Email service provider (e.g., Google, Microsoft)

`findymail_find_email_from_name`

Find someone

输入

参数	类型	必填	描述
`name`	string	是	Person's full name (e.g., 'John Doe')
`domain`	string	是	Company domain (preferred) or company name (e.g., stripe.com)
`apiKey`	string	是	Findymail API Key

输出

参数	类型	描述
`contact`	object	Contact information
↳ `name`	string	Contact full name
↳ `email`	string	Contact email address
↳ `domain`	string	Email domain

`findymail_find_emails_by_domain`

Find verified contacts at a given domain matching one or more target roles (max 3 roles). Limited to 5 concurrent synchronous requests.

输入

参数	类型	必填	描述
`domain`	string	是	Company domain (e.g., stripe.com)
`roles`	array	是	Target roles at the company (max 3, e.g., ["CEO", "Founder"])
`items`	string	否	No description
`apiKey`	string	是	Findymail API Key

输出

参数	类型	描述
`contacts`	array	List of contacts found
↳ `name`	string	Contact full name
↳ `email`	string	Contact email address
↳ `domain`	string	Email domain

`findymail_find_email_from_linkedin`

Find someone

输入

参数	类型	必填	描述
`linkedin_url`	string	是	Person's LinkedIn URL or username (e.g., 'https://linkedin.com/in/johndoe' or 'johndoe')
`apiKey`	string	是	Findymail API Key

输出

参数	类型	描述
`contact`	object	Contact information
↳ `name`	string	Contact full name
↳ `email`	string	Contact email address
↳ `domain`	string	Email domain

`findymail_reverse_email_lookup`

Find a business profile from an email address. Uses 1 finder credit if a profile is found, 2 credits if returning full profile data.

输入

参数	类型	必填	描述
`email`	string	是	Work or personal email address to look up
`with_profile`	boolean	否	Whether to return enriched profile metadata (default: false)
`apiKey`	string	是	Findymail API Key

输出

参数	类型	描述
`email`	string	The email address that was looked up
`linkedin_url`	string	LinkedIn profile URL
`fullName`	string	Full name from profile
`username`	string	LinkedIn username
`headline`	string	Profile headline
`jobTitle`	string	Current job title
`summary`	string	Profile summary
`city`	string	City
`region`	string	Region or state
`country`	string	Country
`companyLinkedinUrl`	string	Current company LinkedIn URL
`companyName`	string	Current company name
`companyWebsite`	string	Current company website
`isPremium`	boolean	Whether the profile has LinkedIn Premium
`isOpenProfile`	boolean	Whether the profile is an Open Profile
`skills`	array	List of profile skills
`jobs`	array	Job history entries
`educations`	array	Education history (school, degree, fieldOfStudy, startDate, endDate)
`certificates`	array	Certifications (name, issuingOrganization, issueDate, expirationDate)

`findymail_get_company`

Retrieve company information from a LinkedIn URL, domain, or company name. Uses 1 finder credit per successful response.

输入

参数	类型	必填	描述
`linkedin_url`	string	否	Company LinkedIn URL (e.g., https://www.linkedin.com/company/stripe/\)
`domain`	string	否	Company domain (e.g., stripe.com)
`name`	string	否	Company name (e.g., Stripe)
`apiKey`	string	是	Findymail API Key

输出

参数	类型	描述
`name`	string	Company name
`domain`	string	Company domain
`company_size`	string	Employee headcount range (e.g., 1001-5000)
`industry`	string	Industry classification
`linkedin_url`	string	Company LinkedIn URL
`description`	string	Company description

`findymail_find_employees`

Find employees at a company by website and target job titles. Uses 1 credit per found contact. Does not return email addresses.

输入

参数	类型	必填	描述
`website`	string	是	Company website or domain (e.g., google.com)
`job_titles`	array	是	Target job titles to search for (max 10, e.g., ["Software Engineer", "CEO"])
`items`	string	否	No description
`count`	number	否	Number of contacts to return (max 5, default 1)
`apiKey`	string	是	Findymail API Key

输出

参数	类型	描述
`employees`	array	List of employees matching the search criteria
↳ `name`	string	Employee full name
↳ `linkedinUrl`	string	LinkedIn profile URL
↳ `companyWebsite`	string	Company website
↳ `companyName`	string	Company name
↳ `jobTitle`	string	Job title

`findymail_find_phone`

Find someone

输入

参数	类型	必填	描述
`linkedin_url`	string	是	Person's LinkedIn URL or username (e.g., 'https://linkedin.com/in/johndoe' or 'johndoe')
`apiKey`	string	是	Findymail API Key

输出

参数	类型	描述
`phone`	string	Phone number in E.164 format. Only available for US numbers.
`line_type`	string	Phone line type (e.g., "Mobile", "Landline")

`findymail_search_technologies`

Search the technology catalog by name. Returns up to 25 technologies. Free endpoint, rate limited to 10 requests per minute.

输入

参数	类型	必填	描述
`q`	string	是	Search term (min 2 characters, e.g., "React")
`apiKey`	string	是	Findymail API Key

输出

参数	类型	描述
`technologies`	array	List of technologies
↳ `name`	string	Technology name
↳ `category`	string	Technology category
↳ `subcategory`	string	Technology subcategory
↳ `last_detected_at`	string	Last detection timestamp (ISO 8601)

`findymail_lookup_technologies`

Get the technology stack for a company by domain. Optionally filter by technology names. 1 finder credit if technologies are found, free otherwise.

输入

参数	类型	必填	描述
`domain`	string	是	Company domain to look up (e.g., stripe.com)
`technologies`	array	否	Filter by technology names, case-insensitive (e.g., ["React", "TypeScript"])
`items`	string	否	No description
`apiKey`	string	是	Findymail API Key

输出

参数	类型	描述
`technologies`	array	List of technologies
↳ `name`	string	Technology name
↳ `category`	string	Technology category
↳ `subcategory`	string	Technology subcategory
↳ `last_detected_at`	string	Last detection timestamp (ISO 8601)
`domain`	string	The resolved company domain

`findymail_get_credits`

Retrieve the remaining finder and verifier credits for the authenticated account.

输入

参数	类型	必填	描述
`apiKey`	string	是	Findymail API Key

输出

参数	类型	描述
`credits`	number	Remaining finder credits
`verifier_credits`	number	Remaining verifier credits

Findymail

On this page