← Back to Library
capabilities

Email Finder Tomba

Email finder and verifier - find emails from domains, LinkedIn, or company search

Gooseby Athina AI
Run in GooseworksView skill in Github
Install
Terminal
npx gooseworks install --all

# then, in Claude Code, Cursor, or Codex:
/gooseworks use the email-finder-tomba skill
About This Skill

Tomba - Email Finding & Verification

Setup

Read your credentials from ~/.gooseworks/credentials.json:

export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")

If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login

All endpoints use Bearer auth: -H "Authorization: Bearer $GOOSEWORKS_API_KEY"

Find and verify email addresses from domains, LinkedIn profiles, or natural language search.

Capabilities

  • Validate Phone: Validate a phone number and get carrier information
  • Domain Status: Check the status and availability of a domain
  • Email Format: Get the email format patterns used by a domain (e.g. first.last, firstlast)
  • Find Person: Get person information from an email address
  • Combined Enrichment: Get combined person and company information from an email
  • Domain Suggestions: Get domain suggestions for a company name
  • Email Count: Get the count of email addresses for a domain, broken down by department and seniority
  • Author Finder: Find the email address of a blog post author from the article URL
  • LinkedIn Finder: Find the email address from a LinkedIn profile URL
  • Technology Stack: Discover technologies used by a website
  • Verify Email: Verify the deliverability of an email address
  • Find Company: Get company information from a domain
  • Location: Get employee location distribution for a domain
  • Domain Search: Search emails based on a website domain
  • Email Enrichment: Enrich an email address with person and company data (name, location, social handles)
  • Find Phone: Find phone numbers associated with an email, domain, or LinkedIn profile
  • Similar Domains: Find domains similar to a given domain
  • Email Finder: Find the most likely email address from a domain name, first name, and last name
  • Email Sources: Find the sources where an email was found on the web
  • Search Companies: Search for companies using natural language queries or structured filters

Usage

Validate Phone

Validate a phone number and get carrier information.

Parameters:

  • phone* (string) - Phone number to validate
  • country_code (string) - Country code (e.g., US)
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/phone-validator","query":{"phone":"+14155552671"}}'

Domain Status

Check the status and availability of a domain.

Parameters:

  • domain* (string) - Domain to check
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/domain-status","query":{"domain":"stripe.com"}}'

Email Format

Get the email format patterns used by a domain (e.g. first.last, firstlast).

Parameters:

  • domain* (string) - Domain name, e.g. stripe.com
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/email-format","query":{"domain":"stripe.com"}}'

Find Person

Get person information from an email address.

Parameters:

  • email* (string) - Email address to look up
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/people/find","query":{"email":"john@stripe.com"}}'

Combined Enrichment

Get combined person and company information from an email.

Parameters:

  • email* (string) - Email address to enrich
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/combined/find","query":{"email":"john@stripe.com"}}'

Domain Suggestions

Get domain suggestions for a company name

Parameters:

  • query* (string) - The domain or company name to find suggestions for
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/domain-suggestions","query":{"query":"Google"}}'

Email Count

Get the count of email addresses for a domain, broken down by department and seniority.

Parameters:

  • domain* (string) - Domain name, e.g. stripe.com
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/email-count","query":{"domain":"openai.com"}}'

Author Finder

Find the email address of a blog post author from the article URL.

Parameters:

  • url* (string) - URL of the blog post/article
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/author-finder","query":{"url":"https://example.com/blog/post"}}'

LinkedIn Finder

Find the email address from a LinkedIn profile URL.

Parameters:

  • url* (string) - LinkedIn profile URL
  • enrich_mobile (string) - Set to true to get phone number
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/linkedin","query":{"url":"https://linkedin.com/in/johndoe"}}'

Technology Stack

Discover technologies used by a website.

Parameters:

  • domain* (string) - Domain to analyze
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/technology","query":{"domain":"stripe.com"}}'

Verify Email

Verify the deliverability of an email address.

Parameters:

  • email* (string) - The email address to verify
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/email-verifier","query":{"email":"john@example.com"}}'

Find Company

Get company information from a domain.

Parameters:

  • domain* (string) - Domain name (e.g., stripe.com)
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/companies/find","query":{"domain":"anthropic.com"}}'

Location

Get employee location distribution for a domain.

Parameters:

  • domain* (string) - Domain name, e.g. stripe.com
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/location","query":{"domain":"stripe.com"}}'

Domain Search

Search emails based on a website domain. Returns all email addresses found on the internet for a given domain, with organization info and employee details.

Parameters:

  • domain* (string) - Domain name to search, e.g. stripe.com
  • company* (string) - Company name (3-75 chars)
  • page (string) - Page number (default 1)
  • limit (string) - Results per page: 10, 20, or 50 (default 10)
  • country (string) - Two-letter country code filter
  • department (string) - Department filter: engineering, sales, finance, hr, it, marketing, operations, management, executive, legal, support, communication, software, security, pr, warehouse, diversity, administrative, facilities, accounting
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/domain-search","query":{"domain":"stripe.com"}}'

Email Enrichment

Enrich an email address with person and company data (name, location, social handles).

Parameters:

  • email* (string) - Email address to enrich
  • enrich_mobile (string) - Set to true to get phone number
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/enrich","query":{"email":"john@stripe.com"}}'

Find Phone

Find phone numbers associated with an email, domain, or LinkedIn profile.

Parameters:

  • email (string) - Email address to find phone for
  • domain (string) - Domain to find phone numbers for
  • linkedin (string) - LinkedIn profile URL
  • full (boolean) - Set to true to get all phone numbers
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/phone-finder","query":{"domain":"stripe.com","first_name":"John","last_name":"Doe"}}'

Similar Domains

Find domains similar to a given domain.

Parameters:

  • domain* (string) - Domain to find similar domains for
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/similar","query":{"domain":"stripe.com"}}'

Email Finder

Find the most likely email address from a domain name, first name, and last name.

Parameters:

  • domain* (string) - Domain name, e.g. stripe.com
  • company* (string) - Company name (3-75 chars)
  • full_name (string) - Full name of the person
  • first_name (string) - First name of the person
  • last_name (string) - Last name of the person
  • enrich_mobile (string) - Set to true to get phone number
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/email-finder","query":{"domain":"stripe.com","first_name":"John","last_name":"Doe"}}'

Email Sources

Find the sources where an email was found on the web.

Parameters:

  • email* (string) - Email address to find sources for
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/email-sources","query":{"email":"john@stripe.com"}}'

Search Companies

Search for companies using natural language queries or structured filters. AI assistant generates appropriate filters from your query.

Parameters:

  • query (string) - Natural language query (8-100 chars). AI generates filters from this. Use only on first request, then use filters for pagination.
  • filters (object) - Structured filters: company, location_country, location_city, location_state, industry, size, type, keywords, founded, technologies, similar, revenue, sic, naics. Each has include/exclude arrays.
  • page (integer) - Page number for pagination (1-1000, default: 1)
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/reveal/search","body":{"query":"AI startups in San Francisco with 50+ employees"}}'

Use Cases

  1. Sales Prospecting: Find contact emails at target companies
  2. Lead Generation: Build email lists from LinkedIn
  3. Email Validation: Clean email lists before campaigns
  4. Company Research: Find companies matching criteria
  5. Outreach: Verify emails before sending

Discover More

For full endpoint details and parameters:

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/search \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"tomba API endpoints"}' List all endpoints
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/details \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/phone-validator"}'   # Get endpoint details

What's included

·
Validate Phone*: Validate a phone number and get carrier information
·
Domain Status*: Check the status and availability of a domain
·
Email Format*: Get the email format patterns used by a domain (e.g. first.last, firstlast)
·
Find Person*: Get person information from an email address
·
Combined Enrichment*: Get combined person and company information from an email
·
Domain Suggestions*: Get domain suggestions for a company name
·
Email Count*: Get the count of email addresses for a domain, broken down by department and seniority
·
Author Finder*: Find the email address of a blog post author from the article URL
·
LinkedIn Finder*: Find the email address from a LinkedIn profile URL
·
Technology Stack*: Discover technologies used by a website
·
Verify Email*: Verify the deliverability of an email address
·
Find Company*: Get company information from a domain
·
Location*: Get employee location distribution for a domain
·
Domain Search*: Search emails based on a website domain
·
Email Enrichment*: Enrich an email address with person and company data (name, location, social handles)
·
Find Phone*: Find phone numbers associated with an email, domain, or LinkedIn profile
·
Similar Domains*: Find domains similar to a given domain
·
Email Finder*: Find the most likely email address from a domain name, first name, and last name
·
Email Sources*: Find the sources where an email was found on the web
·
Search Companies*: Search for companies using natural language queries or structured filters
You Might Also Like

Video Production Harness

Full video production sequence with script review, actual ingredient choices, controlled generation, editing, evidence-based quality review, polish, captions and delivery. A host binding supplies project storage, authentic approvals, provider access and billing.

Render Street Interview

Build a vox-pop street interview video ad. An interviewer with a handheld mic asks passers-by one question about the brand's product, they give blunt wrong guesses, one gives the real answer, and the cut lands on a branded end card. Generates the takes through the GooseWorks fal proxy (Seedance 2.0 with native voice), then grades, re-cuts, captions and gates them locally. Use for the street-interview format.

Write Video Ad Script

Write the words of a short-form video ad (voiceover, dialogue, chat bubbles, on-screen lines) the way performance creative teams do instead of from a blank page. Builds the script from the buyers' own words, the beat sheet of an ad that already works and three deliberately different angles, filters them with a rule check and a second non-Claude model, and takes the strongest into the review with the other two as one-line swaps. Use it in every video ad run before any paid step, and whenever the user asks to write, rewrite or improve a video ad script or says a script sounds generic or AI-written.

Newsletter

Learn to build Growth systems with AI

2-3 compounding systems per week using Claude Code, OpenClaw, and more.