# Perl Client Library

## Installation

install from source (not necessary for use in your application), download the source and run the following commands:

```shell
perl Makefile.PL
make
make test
make install
```

## Usage

### Domain Search

Get email addresses found on the internet.

```perl
use Tomba::Finder;

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

$result = $tomba->DomainSearch('wordpress.org')

print $result;
```

### Email Finder

Find the verified email address of any professional.

```perl
use Tomba::Finder;

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

$result = $tomba->emailFinder('stripe.com', 'fname', 'lname')

print $result;
```

### Email Verifier

Verify the validity of any professional email address with the most complete email checker.

```perl
use Tomba::Finder;

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

$result = $tomba->EmailVerifier('m@wordpress.org')

print $result;
```

## Examples

### Get Account Information

```perl
use Tomba::Finder;

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

$result = $tomba->Account();

print $result;
```

### Email Count

```perl
use Tomba::Finder;

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

$result = $tomba->Count('tomba.io');

print $result;
```

### Finder Services

#### Author Finder

```perl
use Tomba::Finder;

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

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

print $result;
```

#### LinkedIn Finder

```perl
use Tomba::Finder;

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

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

print $result;
```

### Email Enrichment

```perl
use Tomba::Finder;

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

$result = $tomba->Enrichment('b.mohamed@tomba.io');

print $result;
```

### Email Sources

```perl
use Tomba::Finder;

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

$result = $tomba->EmailSources('b.mohamed@tomba.io');

print $result;
```

### Domain and Company Status

#### Auto Complete

```perl
use Tomba::Finder;

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

$result = $tomba->Autocomplete('google');

print $result;
```

#### Domain Status

```perl
use Tomba::Finder;

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

$result = $tomba->Status('gmail.com');

print $result;
```

### Activity Logs

```perl
use Tomba::Finder;

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

$result = $tomba->Logs();

print $result;
```

### Usage Statistics

```perl
use Tomba::Finder;

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

$result = $tomba->Usage();

print $result;
```

For more sample codes, check the [**examples/**](https://github.com/tomba-io/perl/tree/master/examples) folder.