Apollo.io B2B Person Enrichment & Verified Work Email Finder (x402)

{
  "schema_version": "a2a-1.0",
  "name": "Apollo.io B2B Person Enrichment & Verified Work Email Finder (x402)",
  "description": "Zero-signup, pay-per-match B2B Person Enrichment, Executive Work Email Finder, and LinkedIn-to-Email Resolver powered by Apollo.io ($0.03 USDC on Base Mainnet via x402 v2 \u2014 Free-on-Miss: $0.00 charged if no deliverable email is found). Resolve (1) first_name + last_name + company domain/name, (2) LinkedIn profile URL, or (3) email into a deterministic JSON profile with verified work email, job title, seniority, firmographics (headcount, industry, founded year), and full employment history.",
  "url": "https://enrichmatch.dev",
  "provider": {
    "organization": "Apollo.io B2B Enrichment Gateway",
    "contact": "info@nrorvem.com"
  },
  "version": "0.3.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": true,
    "zeroSignupExecution": true,
    "prePaymentInputValidation": true,
    "freeOnMiss": true
  },
  "authentication": {
    "schemes": [
      "x402"
    ],
    "credentialsRequired": false,
    "description": "Payment IS the credential. Send requests directly to /api/v1/enrich/person or /api/mcp; settle the HTTP 402 challenge with USDC on Base via the PAYMENT-SIGNATURE (or X-PAYMENT) header. Free-on-Miss: payment is only settled on-chain when a deliverable email is returned."
  },
  "paymentRails": [
    {
      "protocol": "x402",
      "version": 2,
      "x402Version": 2,
      "network": "eip155:8453",
      "legacyNetwork": "base",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "symbol": "USDC",
      "priceUsd": "0.03",
      "amountAtomic": "30000",
      "freeOnMiss": true,
      "recipientWallet": "0x7C38096030c9CF41Ec551dAcDFC1aBaA60590AbC",
      "facilitatorUrl": "https://api.cdp.coinbase.com/platform/v2/x402"
    }
  ],
  "endpoints": {
    "mcp": "https://enrichmatch.dev/api/mcp",
    "rest_enrich_person": "https://enrichmatch.dev/api/v1/enrich/person",
    "openapi_json": "https://enrichmatch.dev/openapi.json",
    "llms_txt": "https://enrichmatch.dev/llms.txt"
  },
  "skills": [
    {
      "id": "b2b-person-enrichment",
      "name": "Verified B2B Person Enrichment & Work Email Lookup (Free-on-Miss)",
      "description": "Hydrates partial person identifiers (name + domain/company, LinkedIn URL, or reverse email) into a verified B2B executive/prospect profile via Apollo.io /api/v1/people/match. Free-on-Miss: only settles payment ($0.03 USDC) when a deliverable email is returned.",
      "tags": [
        "b2b-enrichment",
        "work-email-finder",
        "linkedin-to-email",
        "reverse-email-lookup",
        "executive-contact-lookup",
        "lead-enrichment",
        "firmographics",
        "sales-intelligence",
        "apollo",
        "x402",
        "free-on-miss",
        "mcp"
      ],
      "matchingIntents": [
        "Find verified work email for a founder, CEO, VP, or engineer at a company domain",
        "Convert a LinkedIn profile URL into a deliverable corporate email and job title",
        "Enrich an email address with full name, seniority, company headcount, and employment history",
        "Look up B2B lead contact details without an Apollo or ZoomInfo subscription"
      ],
      "pricing": {
        "model": "per_match_free_on_miss",
        "amount": "0.03",
        "currency": "USDC",
        "network": "eip155:8453",
        "freeOnMiss": true
      },
      "sla": {
        "p95LatencyMs": 850,
        "averageLatencyMs": 650,
        "uptimeTarget": "99.9%",
        "attributeCompletenessTarget": "95%+",
        "fulfillmentSuccessRate": "100%",
        "freeOnMiss": true,
        "recentCompletedTransactions": 0,
        "verifiedOnChainSettlements": 0,
        "recentSettlementTxHashes": [],
        "recentSettlementProofs": []
      },
      "inputSchema": {
        "type": "object",
        "additionalProperties": true,
        "description": "B2B Person Enrichment & Verified Work Email Finder (Apollo.io): Accepts flexible partial person identifiers\u2014such as (1) LinkedIn profile URL only ('linkedin_url' or 'linkedin'), (2) work or personal email only ('email' for reverse email lookup), (3) name ('name' or 'first_name' + 'last_name') with company domain OR fuzzy company name ('domain', 'organization_name', or 'company', e.g. 'Meta' or 'meta.com'), or (4) Apollo person ID ('id')\u2014and resolves a deterministic B2B executive/prospect profile with verified work email, job title, seniority, department, location, company firmographics, and employment history. Free-on-Miss: only settles payment ($0.03 USDC) when a verified person and deliverable email are returned.",
        "anyOf": [
          {
            "required": [
              "linkedin_url"
            ]
          },
          {
            "required": [
              "email"
            ]
          },
          {
            "required": [
              "id"
            ]
          },
          {
            "required": [
              "first_name",
              "last_name"
            ]
          },
          {
            "required": [
              "name"
            ]
          },
          {
            "required": [
              "first_name",
              "domain"
            ]
          },
          {
            "required": [
              "first_name",
              "organization_name"
            ]
          },
          {
            "required": [
              "first_name",
              "company"
            ]
          },
          {
            "required": [
              "last_name",
              "domain"
            ]
          },
          {
            "required": [
              "last_name",
              "organization_name"
            ]
          },
          {
            "required": [
              "last_name",
              "company"
            ]
          }
        ],
        "properties": {
          "first_name": {
            "type": "string",
            "description": "Target person's first name (e.g., 'Tim'). Optional if 'name', 'linkedin_url', 'email', or 'id' is provided."
          },
          "last_name": {
            "type": "string",
            "description": "Target person's last name (e.g., 'Zheng'). Optional if 'name', 'linkedin_url', 'email', or 'id' is provided."
          },
          "name": {
            "type": "string",
            "description": "Target person's full name (e.g., 'Tim Zheng'). Automatically split into first_name and last_name if needed."
          },
          "domain": {
            "type": "string",
            "description": "Company website domain or URL (e.g., 'apollo.io', 'stripe.com'). Also accepts a company name (e.g., 'Meta', 'Google') and automatically resolves the canonical domain."
          },
          "organization_name": {
            "type": "string",
            "description": "Company or organization name (e.g., 'Apollo.io', 'Meta', 'Google', 'Stripe') if exact domain is unknown."
          },
          "company": {
            "type": "string",
            "description": "Alias for organization_name or domain (e.g., 'Meta', 'Stripe', 'instacart.com')."
          },
          "email": {
            "type": "string",
            "description": "Known work or personal email address for reverse-email enrichment into full LinkedIn, title, firmographics, and career history."
          },
          "linkedin_url": {
            "type": "string",
            "description": "Public LinkedIn profile URL (e.g., 'https://www.linkedin.com/in/tim-zheng') to resolve directly into a verified work email and company profile."
          },
          "id": {
            "type": "string",
            "description": "Optional Apollo.io person ID for direct profile hydration."
          },
          "reveal_personal_emails": {
            "type": "boolean",
            "description": "Whether to include verified personal emails if a corporate work email is unavailable (default: false)."
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "description": "Deterministic B2B Person Profile & Firmographic Payload with cryptographic x402 payment receipt. Free on miss ($0.00 charged if no deliverable email is found).",
        "required": [
          "matched",
          "timestamp",
          "latency_ms",
          "source",
          "person"
        ],
        "properties": {
          "matched": {
            "type": "boolean",
            "description": "True if Apollo resolved the identifiers to a verified person record."
          },
          "timestamp": {
            "type": "string",
            "description": "ISO-8601 execution timestamp."
          },
          "latency_ms": {
            "type": "number",
            "description": "End-to-end API execution latency in milliseconds."
          },
          "source": {
            "type": "string",
            "enum": [
              "apollo_live",
              "apollo_mock"
            ]
          },
          "person": {
            "type": "object",
            "nullable": true,
            "description": "Hydrated prospect/executive record (or null if matched is false).",
            "properties": {
              "apollo_id": {
                "type": "string",
                "description": "Unique Apollo.io person identifier."
              },
              "first_name": {
                "type": "string",
                "nullable": true,
                "description": "First name."
              },
              "last_name": {
                "type": "string",
                "nullable": true,
                "description": "Last name."
              },
              "full_name": {
                "type": "string",
                "nullable": true,
                "description": "Full formatted name."
              },
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Current job title (e.g., 'Founder & CEO', 'VP of Engineering')."
              },
              "headline": {
                "type": "string",
                "nullable": true,
                "description": "LinkedIn or professional headline."
              },
              "seniority": {
                "type": "string",
                "nullable": true,
                "description": "Normalized seniority level (e.g., 'founder', 'c_suite', 'vp', 'director', 'manager')."
              },
              "departments": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Functional departments (e.g., 'c_suite', 'engineering', 'sales')."
              },
              "email": {
                "type": "string",
                "nullable": true,
                "description": "Deliverable B2B work email address."
              },
              "email_status": {
                "type": "string",
                "description": "Deliverability verification status ('verified', 'likely_to_engage', 'unavailable')."
              },
              "linkedin_url": {
                "type": "string",
                "nullable": true,
                "description": "Canonical LinkedIn profile URL."
              },
              "twitter_url": {
                "type": "string",
                "nullable": true,
                "description": "Twitter/X profile URL."
              },
              "github_url": {
                "type": "string",
                "nullable": true,
                "description": "GitHub profile URL."
              },
              "location": {
                "type": "object",
                "description": "Geographic location (city, state, country) of the individual.",
                "properties": {
                  "city": {
                    "type": "string",
                    "nullable": true
                  },
                  "state": {
                    "type": "string",
                    "nullable": true
                  },
                  "country": {
                    "type": "string",
                    "nullable": true
                  }
                }
              },
              "organization": {
                "type": "object",
                "nullable": true,
                "description": "Current employer firmographics: company name, primary_domain, industry, estimated_num_employees (headcount), linkedin_url, and founded_year.",
                "properties": {
                  "id": {
                    "type": "string",
                    "nullable": true
                  },
                  "name": {
                    "type": "string",
                    "nullable": true
                  },
                  "website_url": {
                    "type": "string",
                    "nullable": true
                  },
                  "primary_domain": {
                    "type": "string",
                    "nullable": true
                  },
                  "industry": {
                    "type": "string",
                    "nullable": true
                  },
                  "estimated_num_employees": {
                    "type": "number",
                    "nullable": true
                  },
                  "linkedin_url": {
                    "type": "string",
                    "nullable": true
                  },
                  "founded_year": {
                    "type": "number",
                    "nullable": true
                  }
                }
              },
              "employment_history": {
                "type": "array",
                "description": "Chronological work history of current and past roles, companies, and start/end dates.",
                "items": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "type": "string",
                      "nullable": true
                    },
                    "organization_name": {
                      "type": "string",
                      "nullable": true
                    },
                    "start_date": {
                      "type": "string",
                      "nullable": true
                    },
                    "end_date": {
                      "type": "string",
                      "nullable": true
                    },
                    "current": {
                      "type": "boolean"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  ]
}