leadsforge_people_search $0.001 per call

Search people by company, industry or tech — ids only. Search leads. Accepts the full person filter set. (LeadsForge · People & contact data)

For AI agents: call leadsforge_people_search
POST https://toll402.dev/v1/p/leadsforge.people.search
{
 "companyDomains": {
  "include": [
   "stripe.com"
  ]
 },
 "leadSeniorities": {
  "include": [
   "c_suite"
  ]
 },
 "limit": 2
}
Answers 402 with x402 payment requirements; pay with any x402 client (@x402/fetch, x402 for Python, toll402-client, toll402-mcp) or send a prepaid-credits key as x-toll402-key (https://toll402.dev/credits). Paid per call via x402 (USDC on Base) or with a prepaid-credits key (x-toll402-key, card at /credits); charged only on success. Start at /llms.txt or connect the MCP server: npx -y toll402-mcp · remote https://toll402.dev/mcp.

Input schema

{
 "type": "object",
 "properties": {
  "companyDomains": {
   "type": "object",
   "description": "{include: [domain], exclude: [domain]} — the way to target named companies",
   "examples": [
    {
     "include": [
      "stripe.com"
     ]
    }
   ]
  },
  "companyNames": {
   "type": "object",
   "description": "{include/exclude} free text, partial and case-insensitive",
   "examples": [
    {
     "include": [
      "Stripe"
     ]
    }
   ]
  },
  "companyIndustries": {
   "type": "object",
   "description": "{include/exclude}; EXACT values from leadsforge.people.search.filters.industries",
   "examples": [
    {
     "include": [
      "software development"
     ]
    }
   ]
  },
  "companyTypes": {
   "type": "object",
   "description": "{include/exclude}; ids from leadsforge.people.search.filters.company_types",
   "examples": [
    {
     "include": [
      "PRIVATELY_HELD"
     ]
    }
   ]
  },
  "companyFundingRounds": {
   "type": "object",
   "description": "{include/exclude}; ids from leadsforge.people.search.filters.funding_types",
   "examples": [
    {
     "include": [
      "SERIES_B"
     ]
    }
   ]
  },
  "companyRevenueRanges": {
   "type": "array",
   "description": "values from leadsforge.people.search.filters.revenue_ranges",
   "examples": [
    [
     "small_upper"
    ]
   ]
  },
  "companyEmployeeNumberRange": {
   "type": "object",
   "description": "{min, max}",
   "examples": [
    {
     "min": 50,
     "max": 500
    }
   ]
  },
  "companyFoundedYearRange": {
   "type": "object",
   "description": "{min, max}",
   "examples": [
    {
     "min": 2010,
     "max": 2024
    }
   ]
  },
  "companyYearsInBusinessRange": {
   "type": "object",
   "description": "{min, max}"
  },
  "companyLocations": {
   "type": "object",
   "description": "{include/exclude} free text",
   "examples": [
    {
     "include": [
      "United States"
     ]
    }
   ]
  },
  "companyTechnologies": {
   "type": "object",
   "description": "{any: [...], all: [...]} free text",
   "examples": [
    {
     "any": [
      "hubspot"
     ]
    }
   ]
  },
  "companyKeywords": {
   "type": "object",
   "description": "{include, exclude, all} free text"
  },
  "companyIDs": {
   "type": "object",
   "description": "{include/exclude} LeadsForge company ids"
  },
  "companyRequired": {
   "type": "boolean",
   "description": "only return leads that have a resolved company"
  },
  "leadSeniorities": {
   "type": "object",
   "description": "{include/exclude}; values from leadsforge.people.search.filters.seniorities",
   "examples": [
    {
     "include": [
      "c_suite"
     ]
    }
   ]
  },
  "leadDepartments": {
   "type": "object",
   "description": "{include/exclude}; values from leadsforge.people.search.filters.departments",
   "examples": [
    {
     "include": [
      "master_sales"
     ]
    }
   ]
  },
  "leadJobTitles": {
   "type": "object",
   "description": "job-title filter, free text",
   "examples": [
    {
     "include": [
      "Head of Growth"
     ]
    }
   ]
  },
  "leadLocations": {
   "type": "object",
   "description": "{include/exclude} free text",
   "examples": [
    {
     "include": [
      "United States"
     ]
    }
   ]
  },
  "leadLanguages": {
   "type": "object",
   "description": "language filter"
  },
  "leadTenure": {
   "type": "object",
   "description": "{min, max} years in current role"
  },
  "leadIDs": {
   "type": "object",
   "description": "{include/exclude} LeadsForge person ids"
  },
  "limit": {
   "type": "integer",
   "description": "page size",
   "examples": [
    2
   ]
  },
  "maxContactsPerCompany": {
   "type": "integer",
   "description": "cap results per company so one big employer cannot fill the page",
   "examples": [
    3
   ]
  },
  "excludeEmails": {
   "type": "array",
   "description": "suppression list — emails you already own (documented in the route description, not in the schema)"
  },
  "excludeDomains": {
   "type": "array",
   "description": "suppression list — company domains to skip"
  },
  "excludeLinkedInURLs": {
   "type": "array",
   "description": "suppression list — LinkedIn profile URLs to skip"
  }
 },
 "additionalProperties": true,
 "description": "returns person ids plus name, job title, location and firmographics — NOT email or phone. Feed the returned `id` into the enrichment routes as `personID` to reveal a contact channel."
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI