polymerdao/polymer-pay-tomba

Tomba

Email finding and verification API. Find email addresses from domain and name, verify email deliverability, discover company technologies, and get person/company enrichment.

Authentication

All requests route through the Polymer Pay proxy. Include your Polymer Pay API key in every request:

{
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Base URL: https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba

To get an Polymer Pay API key, sign up at https://my.pay.polymerlabs.org/dashboard/api-keys.

Common Operations

Email Finder

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

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/email-finder?domain=stripe.com&full_name=Sundar+Pichai",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Domain Search

Search emails based on website domain.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/domain-search?domain=stripe.com&company=Stripe",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Enrich Email

Enrich an email address with person and company data.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/[email protected]",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Email Verifier

Verify deliverability of an email address.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/[email protected]",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Find LinkedIn Email

Find email from a LinkedIn profile URL.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/linkedin?url=https://linkedin.com/in/sundarpichai",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Company Finder

Get company information from a domain.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/companies/find?domain=stripe.com",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Technology Finder

Discover technologies used by a website.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/technology?domain=stripe.com",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Phone Finder

Find phone numbers associated with an email or domain.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/[email protected]",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Domain Suggestions

Get domain suggestions for a company name.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/domain-suggestions?query=Stripe",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Company Reveal Search

Search for companies using natural language queries or structured filters.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/reveal/search",
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "AI companies in San Francisco",
    "filters": {
      "size": {"include": ["11-50", "51-200"]}
    }
  }
}

Author Finder

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

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/author-finder?url=https://example.com/blog/post",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Email Format

Get email format patterns used by a domain.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/email-format?domain=stripe.com",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Employee Locations

Get employee location distribution for a domain.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/location?domain=stripe.com",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Email Count

Get count of email addresses for a domain by department and seniority.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/email-count?domain=stripe.com",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Domain Status

Check the status and availability of a domain.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/domain-status?domain=stripe.com",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Person Finder

Get person information from an email address.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/people/[email protected]",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Combined Find

Get combined person and company information from an email.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/combined/[email protected]",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Phone Validator

Validate a phone number and get carrier information.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/phone-validator?phone=+14155551234&country_code=US",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Similar Domains

Find domains similar to a given domain.

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/similar?domain=stripe.com",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Email Sources

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

Pricing: $0.01

{
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/tomba/v1/[email protected]",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

When to Use

• Email Discovery: Find email addresses for outreach
• Email Verification: Verify deliverability before sending
• Lead Enrichment: Enrich leads with company and contact data
• Technology Intelligence: Discover tech stacks of companies
• Phone Discovery: Find phone numbers for prospects

Best Practices

1. Verify Before Sending: Always verify emails before cold outreach
2. Use Multiple Sources: Combine finder and enrich for best data
3. Department Filters: Use department filters for targeted discovery

• For errors -- See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting

| Code | Cause | Solution | |------|-------|----------| | 400 | Invalid parameters | Check required fields and format | | 401 | Missing API key | Include x-polymer-pay-api-key header | | 402 | Payment required | Check Polymer Pay account balance | | 404 | Not found | Email/person not found | | 429 | Rate limited | Implement exponential backoff | | 500 | Server error | Retry with exponential backoff |