API Reference

Welcome to the Plutyx API. Access 50M+ contacts, verify emails, enrich data, and automate prospecting.

Base URL: https://plutyx.com

Authentication

All requests require an API key in the X-API-Key header.

curl https://plutyx.com/email-finder?domain=company.com&first_name=John \
  -H "X-API-Key: rmr_YOUR_KEY_HERE"

Get your key in: Dashboard → API Keys

Email Finder

GET /email-finder

Find a professional email for a person at a specific domain.

Parameters

domainstringrequiredCompany domain (for example, company.com)
first_namestringrequiredPerson's first name
last_namestringoptionalPerson's last name

Example

GET /email-finder?domain=company.com&first_name=John&last_name=Smith

Response

{
  "email": "john.smith@company.com",
  "confidence": 87,
  "smtp_valid": true,
  "sources": ["website", "pattern_match"],
  "pattern": "{first}.{last}@{domain}"
}
GET /domain-search

Find all professional emails associated with a domain.

Parameters

domainstringrequiredDomain to search
limitintegeroptionalMax results (1-50, default: 10)

Response

{
  "domain": "company.com",
  "company": "Company Inc.",
  "emails": [
    {"email": "contact@company.com", "name": "John Smith", "position": "CEO"},
    {"email": "sales@company.com", "name": "Mary Santos", "position": "Sales"}
  ],
  "pattern": "{first}@{domain}",
  "total": 8
}

Email Verifier

GET /email-verifier

Verify email deliverability via DNS + SMTP.

Parameters

emailstringrequiredEmail to verify

Response

{
  "email": "john@company.com",
  "smtp_verified": true,
  "status": "deliverable",
  "code": 250,
  "mx_found": true
}

Bulk Operations

POST /bulk-email-verifier

Verify multiple emails at once (max 100 per request).

Body (JSON)

{"emails": ["a@company.com", "b@company.com", ...]}

Response

{
  "results": [
    {"email": "a@company.com", "status": "deliverable"},
    {"email": "b@company.com", "status": "undeliverable"}
  ],
  "total": 2,
  "valid": 1
}

Generate Leads

GET /generate-leads

Generate qualified B2B leads by niche and location. Our AI scans 15+ sources in parallel.

Parameters

nichestringrequiredMarket segment (for example, "Dental clinic")
locationstringrequiredCity/state (for example, "Chicago, IL")
limitintegeroptionalLead count (1-200, default: 20)
include_phonesbooleanoptionalInclude phone numbers (default: true)

Example

GET /generate-leads?niche=law+firms&location=Chicago,+IL&limit=50
X-API-Key: rmr_your_key

Response

{
  "leads": [
    {
      "name": "Smith & Associates",
      "email": "contact@smithlaw.com",
      "phone": "+1 312-555-0199",
      "website": "smithlaw.com",
      "address": "200 W Madison St, Chicago, IL",
      "rating": 4.7,
      "confidence": 85,
      "tech_stack": ["WordPress", "Google Analytics"],
      "source": "google_maps"
    }
  ],
  "total": 50,
  "cache_hit": false
}

Maps Search

GET /maps-search

Search companies on Google Maps by category and location.

Parameters

querystringrequiredCategory or company name
locationstringrequiredLocation (city, state)
limitintegeroptionalMax results (default: 20)

Crawler

GET /crawl

Crawl a site and extract emails, phones, social profiles, and contact points.

Parameters

urlstringrequiredWebsite URL to crawl
depthintegeroptionalCrawl depth (1-3, default: 1)

Company Enrichment

GET /enrich-company

Enrich a company with founding year, sector, size, tech stack, and social profiles.

Parameters

domainstringrequiredCompany domain

Intent Signals

GET /intent-signals

Detect buying intent signals such as open roles, recent news, funding, and expansion.

Parameters

domainstringrequiredCompany domain

Org Chart

GET /org-chart

Generate an org chart with roles and decision-maker contacts.

Parameters

domainstringrequiredCompany domain

LinkedIn Finder

GET /linkedin-finder

Find the public LinkedIn profile of a person or company.

Parameters

namestringrequiredName of the person or company
companystringoptionalCompany name (optional refinement)

Lists

GET /lists

List all of your lead lists.

POST /lists

Create a new list.

Body (JSON)

{"name": "Chicago Clinics", "description": "November campaign"}

Email Sequences

GET /sequences

List all of your email sequences.

GET /sequences/{id}/analytics

Return open and click metrics for the sequence.

Response

{
  "total_enrolled": 120,
  "opens": 48,
  "clicks": 12,
  "open_rate": 40.0,
  "click_rate": 10.0,
  "recent_events": [...]
}

CRM Export

GET /export/hubspot

Export the latest results as a HubSpot import CSV.

GET /export/pipedrive

Export in Pipedrive format.

GET /export/salesforce

Export in Salesforce Leads format.

Plutyx API v1.0 • Dashboard • Support: support@plutyx.com