polymerdao/polymer-pay-ortho-hunter

Hunter (x402.orth.sh)

Hunter.io API for finding and verifying professional email addresses. Domain search, email finder, email verification, and company/person enrichment through the Polymer Pay proxy. No API key needed — payment is handled automatically.

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/hunter

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 for a person given their name and company domain.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/hunter/v2/email-finder",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "domain": "stripe.com",
    "first_name": "Patrick",
    "last_name": "Collison"
  }
}

Response: JSON with email address, confidence score, and sources.

Email Verifier

Verify if an email address is deliverable.

Pricing: $0.01

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

Response: JSON with status: valid, invalid, accept_all, webmail, disposable, or unknown.

Domain Search

Find all email addresses for a domain.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/hunter/v2/domain-search",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "domain": "stripe.com",
    "limit": 10
  }
}

Response: JSON with emails, sources, confidence scores, and verification status.

Company Finder

Get detailed company information from a domain.

Pricing: $0.01

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

Response: JSON with company details: industry, description, location, size, tech stack, funding.

Email Count

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

Pricing: $0.01

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

Response: JSON with email counts by department and seniority level.

Combined Find

Get both person AND company information from an email address in a single request.

Pricing: $0.01

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

Response: JSON with both person and company information.

People Find

Get detailed person information from an email address.

Pricing: $0.01

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

Response: JSON with person details including name, location, employment, social profiles.

Discover Companies

Find companies matching criteria using filters or natural language.

Pricing: $0.01

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/hunter/v2/discover",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "Companies in Europe in Tech",
    "limit": 10
  }
}

Response: JSON with matching companies.

When to Use

• Email finding — User needs to find a professional email address for a contact
• Email verification — User wants to verify if an email is deliverable
• Domain research — User wants to find all email addresses for a company
• Company enrichment — User needs company information from a domain

Best Practices

• Use domain as primary — Always prefer domain over company name for accuracy
• Verify before sending — Always verify emails before using them in campaigns
• Check confidence scores — Use emails with high confidence scores for better deliverability
• Filter by department — Use department and seniority filters to target specific roles
• For errors — See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting