{"openapi":"3.1.0","info":{"title":"MailFerret","version":"1.0.0","description":"Work email finder and email verifier for AI agents: find anyone's business email from name + company domain, verify deliverability before sending, and read a company's email setup (provider, catch-all, SaaS tools from SPF). Live SMTP verification, catch-all detection, pay only for verified results. x402, USDC on Base or Arbitrum, no API key.","contact":{"email":"mailferret@appin60.com","url":"https://mailferret.appin60.com"},"x-guidance":"To find someone's work email: POST /find with JSON {first_name, last_name, domain} ($0.01, charged only when a mailbox is verified). To check an address before sending: POST /verify with JSON {email} ($0.003). For a company profile (name, description, logo, socials, website tech, email setup): POST /company {domain} ($0.008). For a company's mail provider, catch-all status, SaaS tools from SPF, public emails and address pattern: POST /domain with JSON {domain} ($0.005). Both pay via x402 in USDC on Base or Arbitrum."},"servers":[{"url":"https://mailferret.appin60.com"}],"paths":{"/find":{"post":{"operationId":"findWorkEmail","summary":"Find a person's verified work email from name + company domain (SMTP-verified, pay only on success)","description":"Email finder / email lookup: find a person's verified work email address (business email, contact email of a founder, CEO or employee) from first name, last name and company domain, for sales prospecting, lead enrichment, recruiting and cold outreach. A cheap Hunter.io / Apollo email-finder alternative with no API key. MailFerret tries the common corporate patterns (first.last, first, flast, ...) against the company's live mail server over SMTP (no email is sent), detects catch-all domains, and returns the address the server confirms. You pay only when a mailbox is verified: not-found, catch-all and inconclusive results return 4xx/5xx and are not charged.","tags":["Email","Enrichment","Sales prospecting"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"first_name":{"type":"string","minLength":1,"description":"Person's first name, e.g. Peer"},"last_name":{"type":"string","description":"Person's last name, e.g. Richelsen (strongly recommended)"},"domain":{"type":"string","minLength":3,"description":"Company domain or website, e.g. cal.com"},"middle_name":{"type":"string","description":"Optional middle name"}},"required":["first_name","domain"]},"example":{"first_name":"Peer","last_name":"Richelsen","domain":"cal.com"}}}},"responses":{"200":{"description":"Verified email found","content":{"application/json":{"example":{"status":"found","email":"peer@cal.com","confidence":"high","verified_by":"smtp_rcpt","catch_all":false,"provider":"google_workspace","domain":"cal.com","mx":["aspmx.l.google.com"],"checked":[{"email":"peer.richelsen@cal.com","result":"rejected"},{"email":"peer@cal.com","result":"accepted"}]}}}},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"422":{"description":"Catch-all domain or no MX: best guess returned, not charged"},"503":{"description":"Inconclusive, not charged"}}}},"/company":{"post":{"operationId":"companyEnrichment","summary":"Company enrichment from a domain: name, description, logo, socials, organization data, website tech, email setup","description":"Company enrichment from a domain: company name, description, logo, social profiles (LinkedIn, X, GitHub...), schema.org organization data (founded, address), website tech (Next.js, Webflow, HubSpot, Stripe, PostHog...), email provider, catch-all, SaaS tools from SPF, DMARC and public email addresses. Built from the company's own website and DNS; no third-party data broker.","tags":["Enrichment","Company","Sales prospecting"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.008"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","minLength":3,"description":"Company domain or website, e.g. zapier.com"}},"required":["domain"]},"example":{"domain":"cal.com"}}}},"responses":{"200":{"description":"Company profile","content":{"application/json":{"example":{"status":"ok","domain":"cal.com","name":"Cal.com | Scheduling Software for Online Bookings","description":"A fully customizable scheduling software...","logo":"https://framerusercontent.com/images/....png","socials":{},"website_tech":["Framer","Google Analytics","PostHog"],"email":{"provider":"google_workspace","catch_all":false,"saas_from_spf":["Google Workspace","SendGrid"],"dmarc_policy":"quarantine","public_emails":[{"email":"support@cal.com","source":"https://cal.com/contact","role":true}]}}}}},"402":{"description":"Payment Required"}}}},"/domain":{"post":{"operationId":"domainEmailIntel","summary":"Company domain email intel: mail provider, catch-all, SPF-revealed SaaS tools, DMARC, public emails, likely pattern","description":"Email intelligence for a company domain: mail provider (Google Workspace, Microsoft 365, Proofpoint...), catch-all status, SaaS tools revealed by SPF (HubSpot, Salesforce, Zendesk, SendGrid...), DMARC policy, public email addresses found on the company's own website with source URLs, and the likely address pattern. Useful before cold outreach or for tech-stack prospecting.","tags":["Email","Enrichment","Tech stack"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","minLength":3,"description":"Company domain or website, e.g. zapier.com"}},"required":["domain"]},"example":{"domain":"zapier.com"}}}},"responses":{"200":{"description":"Domain intel","content":{"application/json":{"example":{"status":"ok","domain":"zapier.com","accepts_mail":true,"provider":"google_workspace","catch_all":true,"email_senders_from_spf":["Google Workspace","Mailgun","HubSpot","Zendesk","Qualtrics"],"dmarc_policy":"reject","public_emails":[{"email":"press@zapier.com","source":"https://zapier.com/press","role":true}],"likely_pattern":null}}}},"402":{"description":"Payment Required"}}}},"/verify":{"post":{"operationId":"verifyEmail","summary":"Verify an email address: MX, provider, catch-all and live SMTP mailbox check","description":"Email verification / email validation / bounce check before sending: verify one email address: syntax, MX records, mail provider (Google Workspace, Microsoft 365, ...), catch-all detection, role/free/disposable flags and a live SMTP RCPT check. Returns deliverable, undeliverable, catch_all or no_mx. Inconclusive results (greylisting) return 503 and are not charged.","tags":["Email","Verification"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","minLength":3,"description":"Email address to verify"}},"required":["email"]},"example":{"email":"zeno.rocha@resend.com"}}}},"responses":{"200":{"description":"Verification result","content":{"application/json":{"example":{"email":"zeno.rocha@resend.com","status":"deliverable","deliverable":true,"catch_all":false,"provider":"google_workspace","role_account":false,"free_provider":false,"disposable":false,"mx":["aspmx.l.google.com"]}}}},"402":{"description":"Payment Required"},"503":{"description":"Inconclusive, not charged"}}}}}}