Copy page

Language Libraries

PHP Client Library

Installation

Code
composer require tomba/php

Usage

Code
use Tomba\Client;
use Tomba\Services\Domain;
use Tomba\Services\Finder;
use Tomba\Services\Verifier;

$client = new Client();
$client->setKey('ta_xxxx')->setSecret('ts_xxxx');

// Domain Search
$domain = new Domain($client);
$result = $domain->domainSearch('stripe.com');

// Email Finder
$finder = new Finder($client);
$result = $finder->emailFinder('stripe.com', 'John', 'Doe');

// Email Verifier
$verifier = new Verifier($client);
$result = $verifier->emailVerifier('john.doe@stripe.com');

Examples

Account

Code
use Tomba\Services\Account;

$account = new Account($client);
$result = $account->getAccount();

Email Count

Code
use Tomba\Services\Count;

$count = new Count($client);
$result = $count->emailCount('stripe.com');

Email Sources

Code
use Tomba\Services\Sources;

$sources = new Sources($client);
$result = $sources->emailSources('john.doe@stripe.com');

Email Format

Code
use Tomba\Services\Format;

$format = new Format($client);
$result = $format->emailFormat('stripe.com');

Domain Status

Code
use Tomba\Services\Status;

$status = new Status($client);
$result = $status->domainStatus('stripe.com');

Autocomplete

Code
use Tomba\Services\Status;

$status = new Status($client);
$result = $status->autoComplete('stripe');

Similar Domains

Code
use Tomba\Services\Similar;

$similar = new Similar($client);
$result = $similar->websites('stripe.com');

Technology

Code
use Tomba\Services\Technology;

$technology = new Technology($client);
$result = $technology->list('stripe.com');

Location

Code
use Tomba\Services\Location;

$location = new Location($client);
$result = $location->getLocation('stripe.com');

Author Finder

Code
use Tomba\Services\Finder;

$finder = new Finder($client);
$result = $finder->authorFinder('https://example.com/blog/post');

LinkedIn Finder

Code
use Tomba\Services\Finder;

$finder = new Finder($client);
$result = $finder->linkedinFinder('https://www.linkedin.com/in/johndoe');

Email Enrichment

Code
use Tomba\Services\Finder;

$finder = new Finder($client);
$result = $finder->emailEnrichment('john.doe@stripe.com');

Phone Finder

Code
use Tomba\Services\Phone;

$phone = new Phone($client);
$result = $phone->finder(['email' => 'john.doe@stripe.com']);

Phone Validator

Code
use Tomba\Services\Phone;

$phone = new Phone($client);
$result = $phone->validator('+14155552671');

Enrichment

Person

Code
use Tomba\Services\Enrichment;

$enrichment = new Enrichment($client);
$result = $enrichment->person('john.doe@stripe.com');

Company

Code
use Tomba\Services\Enrichment;

$enrichment = new Enrichment($client);
$result = $enrichment->company('stripe.com');

Combined

Code
use Tomba\Services\Enrichment;

$enrichment = new Enrichment($client);
$result = $enrichment->combined('john.doe@stripe.com');

Companies Search (Reveal)

Code
use Tomba\Services\Reveal;

$reveal = new Reveal($client);
$result = $reveal->companiesSearch(['query' => 'Stripe']);

Flag

List Flags

Code
use Tomba\Services\Flag;

$flag = new Flag($client);
$result = $flag->listFlags();

Create Flag

Code
use Tomba\Services\Flag;

$flag = new Flag($client);
$result = $flag->createFlag([
    'flag_type' => 'email',
    'value' => 'invalid@example.com',
    'reason' => 'hard_bounce'
]);

Keys Management

Code
use Tomba\Services\Keys;

$keys = new Keys($client);

// List all keys
$result = $keys->getKeys();

// Create a new key
$result = $keys->createKey();

// Delete a key
$result = $keys->deleteKey('key_id');

// Reset a key
$result = $keys->resetKey('key_id');

Leads Management

Code
use Tomba\Services\Leads;

$leads = new Leads($client);

// List leads
$result = $leads->listLeads();

// Create a lead
$result = $leads->createLead([
    'email' => 'john.doe@stripe.com',
    'list_id' => 1
]);

// Update a lead
$result = $leads->updateLead('lead_id', [
    'first_name' => 'John',
    'last_name' => 'Doe'
]);

// Delete a lead
$result = $leads->deleteLead('lead_id');

Lead Lists Management

Code
use Tomba\Services\LeadsLists;

$leadsLists = new LeadsLists($client);

// List all lead lists
$result = $leadsLists->getLists();

// Create a list
$result = $leadsLists->createList(['name' => 'My List']);

// Update a list
$result = $leadsLists->updateList('list_id', ['name' => 'Updated List']);

// Delete a list
$result = $leadsLists->deleteList('list_id');

Lead Attributes Management

Code
use Tomba\Services\LeadsAttributes;

$leadsAttributes = new LeadsAttributes($client);

// List attributes
$result = $leadsAttributes->getLeadAttributes();

// Create an attribute
$result = $leadsAttributes->createLeadAttribute([
    'name' => 'company_size',
    'type' => 'string'
]);

// Update an attribute
$result = $leadsAttributes->updateLeadAttribute('attr_id', [
    'name' => 'company_revenue'
]);

// Delete an attribute
$result = $leadsAttributes->deleteLeadAttribute('attr_id');

Activity Logs

Code
use Tomba\Services\Logs;

$logs = new Logs($client);
$result = $logs->getLogs();

Usage Statistics

Code
use Tomba\Services\Usage;

$usage = new Usage($client);
$result = $usage->getUsage();