name: polymer-pay-tomba description: Email finding and verification API. Find email addresses, verify deliverability, and enrich person/company data. endpoints:
- path: /v1/reveal/search method: POST price: $0.01 description: Company search
- path: /v1/email-finder method: GET price: $0.01 description: Find email from name+domain
- path: /v1/domain-search method: GET price: $0.01 description: Search emails by domain
- path: /v1/enrich method: GET price: $0.01 description: Enrich email with data
- path: /v1/email-verifier method: GET price: $0.01 description: Verify email deliverability
- path: /v1/linkedin method: GET price: $0.01 description: Find email from LinkedIn
- path: /v1/author-finder method: GET price: $0.01 description: Find blog author email
- path: /v1/companies/find method: GET price: $0.01 description: Get company info
- path: /v1/technology method: GET price: $0.01 description: Find company tech
- path: /v1/phone-finder method: GET price: $0.01 description: Find phone numbers
- path: /v1/phone-validator method: GET price: $0.01 description: Validate phone
- path: /v1/email-count method: GET price: $0.01 description: Count emails by dept
- path: /v1/domain-status method: GET price: $0.01 description: Check domain status
- path: /v1/people/find method: GET price: $0.01 description: Get person from email
- path: /v1/combined/find method: GET price: $0.01 description: Combined person+company
- path: /v1/email-format method: GET price: $0.01 description: Get email format pattern
- path: /v1/location method: GET price: $0.01 description: Get employee locations
- path: /v1/similar method: GET price: $0.01 description: Find similar domains
- path: /v1/email-sources method: GET price: $0.01 description: Find email sources metadata: polymer-pay-skill: 📬 requires.env: POLYMER_PAY_API_KEY requires.primaryEnv: POLYMER_PAY_API_KEY registries: {} provider: orthogonal
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/enrich?email=sundar@google.com",
"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-verifier?email=user@company.com",
"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/phone-finder?email=user@company.com",
"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/find?email=user@company.com",
"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/find?email=user@company.com",
"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-sources?email=user@company.com",
"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
- Verify Before Sending: Always verify emails before cold outreach
- Use Multiple Sources: Combine finder and enrich for best data
- 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 |