# Lua Client Library

## Installation

install via [luarocks](https://luarocks.org/modules/benemohamed/tomba)

```bash
luarocks install tomba
```

## Usage

### Domain Search

Get email addresses found on the internet.

```lua
local tomba = require('tomba')

local client = tomba:init("ta_xxxx", "ts_xxxx")

local result = client:domain_search('wordpress.org')

print(result.data)
```

### Email Finder

Find the verified email address of any professional.

```lua
local tomba = require('tomba')

local client = tomba:init("ta_xxxx", "ts_xxxx")

local result = client:email_finder('stripe.com', 'fname', 'lname')

print(result)
```

### Email Verifier

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

```lua
local tomba = require('tomba')

local client = tomba:init("ta_xxxx", "ts_xxxx")

local result = client:email_verifier('m@wordpress.org')

print(result)
```

## Examples

### Get Account Information

```lua
local tomba = require('tomba')

local client = tomba:init("ta_xxxx", "ts_xxxx")

local result = client:account()

print(result.data.email)
```

### Email Count

```lua
local tomba = require('tomba')

local client = tomba:init("ta_xxxx", "ts_xxxx")

local result = client:count('tomba.io')

print(result)
```

### Finder Services

#### Author Finder

```lua
local tomba = require('tomba')

local client = tomba:init("ta_xxxx", "ts_xxxx")

local result = client:author_finder('https://clearbit.com/blog/company-name-to-domain-api')

print(result)
```

#### LinkedIn Finder

```lua
local tomba = require('tomba')

local client = tomba:init("ta_xxxx", "ts_xxxx")

local result = client:linkedin_finder('https://www.linkedin.com/in/alex-maccaw-ab592978')

print(result)
```

### Email Enrichment

```lua
local tomba = require('tomba')

local client = tomba:init("ta_xxxx", "ts_xxxx")

local result = client:enrichment('b.mohamed@tomba.io')

print(result)
```

### Email Sources

```lua
local tomba = require('tomba')

local client = tomba:init("ta_xxxx", "ts_xxxx")

local result = client:email_sources('b.mohamed@tomba.io')

print(result)
```

### Domain and Company Status

#### Auto Complete

```lua
local tomba = require('tomba')

local client = tomba:init("ta_xxxx", "ts_xxxx")

local result = client:autocomplete('google')

print(result)
```

#### Domain Status

```lua
local tomba = require('tomba')

local client = tomba:init("ta_xxxx", "ts_xxxx")

local result = client:status('gmail.com')

print(result)
```

### Activity Logs

```lua
local tomba = require('tomba')

local client = tomba:init("ta_xxxx", "ts_xxxx")

local result = client:logs()

print(result)
```

### Usage Statistics

```lua
local tomba = require('tomba')

local client = tomba:init("ta_xxxx", "ts_xxxx")

local result = client:usage()

print(result)
```

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