/ 
Tomba-Finder-1.1.0
/ Tomba::Finder

NAME

Tomba::Finder - Perl client library for the Tomba.io Email Finder API

SYNOPSIS

use Tomba::Finder;

my $tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");

# Account info
my $account = $tomba->Account();

# Domain search
my $results = $tomba->DomainSearch("tomba.io");

# Email finder
my $email = $tomba->EmailFinder("asana.com", "Dustin", "Moskovitz");

# Email verifier
my $verified = $tomba->EmailVerifier("b.mohamed@tomba.io");

# Phone finder
my $phone = $tomba->PhoneFinder({ email => 'm@wordpress.org' });

DESCRIPTION

This is the official Perl client library for the Tomba.io Email Finder API, allowing you to:

  • Domain Search - Search emails based on a website domain.

  • Email Finder - Generate or retrieve the most likely email address from a domain name, first name and last name.

  • Author Finder - Instantly discover email addresses of article authors.

  • Enrichment - Find job title, company, location and social profiles from an email.

  • Linkedin Finder - Find email addresses from LinkedIn URLs.

  • Email Verifier - Check the deliverability of a given email address.

  • Phone Finder - Find phone numbers associated with an email or domain.

  • Companies Search - Search for companies using natural language or structured filters.

See https://docs.tomba.io for full API documentation.

This module acts as a unified facade. Each API group is also available as a standalone module (Tomba::Account, Tomba::Domain, Tomba::Verifier, etc.) that inherits from Tomba::Client.

EmailFinder

my $data = $tomba->EmailFinder("asana.com", "Dustin", "Moskovitz");

Generates or retrieves the most likely email address from a domain name, a first name and a last name.

See https://docs.tomba.io/api/finder#get-email-finder

Enrichment

my $data = $tomba->Enrichment("b.mohamed@tomba.io");

The Enrichment API lets you look up person and company data based on an email. Retrieve a person's name, location and social handles from an email.

See https://docs.tomba.io/api/enrichment#get-enrich

AuthorFinder

my $data = $tomba->AuthorFinder("https://clearbit.com/blog/company-name-to-domain-api");

Generates or retrieves the most likely email address from a blog post URL.

See https://docs.tomba.io/api/finder#get-author-finder

LinkedinFinder

my $data = $tomba->LinkedinFinder("https://www.linkedin.com/in/alex-maccaw-ab592978");

Generates or retrieves the most likely email address from a LinkedIn URL.

See https://docs.tomba.io/api/finder#get-linkedin

METHODS SUMMARY

Core Methods

  • Account() - Get account information

  • DomainSearch($domain) - Search emails by domain

  • Count($domain) - Get email count for a domain

  • Status($domain) - Check domain status (webmail/disposable)

  • Autocomplete($search) - Auto-complete company names

  • EmailFinder($domain, $first_name, $last_name) - Find an email address

  • Enrichment($email) - Enrich data from an email

  • AuthorFinder($url) - Find author email from a blog post URL

  • LinkedinFinder($url) - Find email from LinkedIn URL

  • EmailVerifier($email) - Verify email deliverability

  • EmailSources($email) - Find email sources on the web

  • PhoneFinder($params) - Find phone numbers

  • PhoneValidator($phone, $country_code) - Validate a phone number

  • EmailFormat($domain) - Get email format patterns

  • GetLocation($domain) - Get employee location breakdown

  • Similar($domain) - Find similar domains

  • Technology($domain) - Get technologies used by a domain

  • PersonFind($email) - Clearbit-compatible Person API

  • CompanyFind($domain) - Clearbit-compatible Company API

  • CombinedFind($email) - Clearbit-compatible Combined API

  • CompaniesSearch($body) - Search companies (POST)

  • Usage() - Check monthly requests

  • Logs() - Get request logs

Keys Management

  • ListKeys() - List API keys

  • GetKey($key_id) - Get a specific API key

  • CreateKey() - Create a new API key

  • ResetKey($key_id) - Reset an API key

  • DeleteKey($key_id) - Delete an API key

Flags

  • ListFlags($params) - List submitted flags

  • CreateFlag($body) - Report incorrect data

Leads Management

  • ListLeads($params) - List leads

  • GetLead($lead_id) - Get a specific lead

  • CreateLead($body) - Create a new lead

  • UpdateLead($lead_id, $body) - Update a lead

  • DeleteLead($lead_id) - Delete a lead

Leads Lists

  • ListLeadsLists() - List leads lists

  • GetLeadsList($list_id) - Get a specific leads list

  • CreateLeadsList($body) - Create a leads list

  • UpdateLeadsList($list_id, $body) - Update a leads list

  • DeleteLeadsList($list_id) - Delete a leads list

Lead Attributes

  • ListAttributes() - List lead attributes

  • GetAttribute($attribute_id) - Get a specific attribute

  • CreateAttribute($body) - Create a lead attribute

  • UpdateAttribute($attribute_id, $body) - Update a lead attribute

  • DeleteAttribute($attribute_id) - Delete a lead attribute

Bulk Operations

  • ListBulks($type, $params) - List bulk operations

  • GetBulk($type, $id) - Get a specific bulk operation

  • LaunchBulk($type, $id) - Launch a bulk operation

  • DeleteBulk($type, $id) - Delete a bulk operation

  • ArchiveBulk($type, $id) - Archive a bulk operation

  • RenameBulk($type, $id, $name) - Rename a bulk operation

  • BulkProgress($type, $id) - Get bulk operation progress

  • BulkDownload($type, $id) - Download bulk results

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Tomba::Finder

You can also look for information at:

Sample codes under examples/ folder.

AUTHOR

Mohamed Ben rebia, <b.mohamed@tomba.io>

COPYRIGHT AND LICENSE

Copyright 2023 Mohamed Benrebia <b.mohamed@tomba.io>

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.