Search for people (employees) at companies matching your criteria.

How It Works

Provide job_titles in people_filters to find people by their role. Use company_filters.definition to narrow down which companies to search. Use company_linkedin_ids to restrict results to a specific list of company LinkedIn IDs.

Job title examples:

• ["Head of Sales", "VP Sales"]
• ["CTO", "VP Engineering"]
• ["Founder", "CEO"]

AI Enrichment

Use the criteria parameter in people_filters to score people against custom criteria. Each person will be evaluated and scored (0-5) with reasoning for each criterion.

Pricing

• First 10 results are free (including AI enrichment)
• A positive credit balance is required for every request, free results included (an organization at 0 credits gets a 402)
• Entirely-free requests are limited per organization by plan: free 50/day + 10/min · starter 200/day + 15/min · growth 500/day + 20/min · pro 750/day + 25/min · agency 1500/day + 30/min · enterprise 3000/day + 30/min (429 beyond); billable requests are not affected
• 1.0 credit per person after the first 10
• +0.1 credits per person per criterion after the first 10

Example: 150 people with 2 criteria = 50 billable × (1.0 + 0.1 × 2) = 60 credits (first 10 are free)

Empty results = 0 credits.

Deduplication

Pass dedup list ids in exclude_lists to skip people you already own — they are not returned and not charged. A companies list excludes everyone at its domains. Free results zone does not apply. See the Deduplication endpoints.

{
  "company_filters": {
    "definition": "B2B SaaS company"
  },
  "company_linkedin_ids": [],
  "page": 1,
  "page_size": 10,
  "people_filters": {
    "criteria": [
      "Has lead gen experience"
    ],
    "geo": [
      "US",
      "GB"
    ],
    "job_titles": [
      "Head of Sales",
      "VP Sales"
    ]
  }
}

{
  "success": true,
  "people": [
    {
      "first_name": "John",
      "last_name": "Smith",
      "title": "Head of Sales",
      "headline": "Sales Leader | B2B SaaS",
      "linkedin_url": "https://linkedin.com/in/johnsmith",
      "geo": "US",
      "follower_count": 1234,
      "company_name": "Acme Inc",
      "company_domain": "acme.com",
      "company_url": "https://acme.com",
      "company_linkedin_id": 12345678,
      "company_size": "51-200",
      "company_geo": "US",
      "company_city": "San Francisco",
      "company_industry": "IT Services and IT Consulting",
      "company_industries_nace": [
        {
          "code": "J63.1.2",
          "description": "Web portals",
          "sector": "Information and communication"
        }
      ],
      "company_founded": 2015,
      "company_traffic": 25000000,
      "company_traffic_growth": 0.12,
      "company_web_metrics_bounce_rate": 0.41,
      "company_web_metrics_pages_per_visit": 3.2,
      "company_web_metrics_time_on_site": 185.5,
      "company_marketing_pixels": [
        "google_ads",
        "meta",
        "linkedin"
      ],
      "company_revenue_annual": 100000000,
      "company_geo_country_employees": {
        "GB": 56,
        "IN": 100,
        "US": 1080,
        "total": 1555
      },
      "company_geo_founders": [
        "US",
        "IN"
      ],
      "company_geo_countries": {
        "DE": 15,
        "GB": 25,
        "US": 60
      },
      "company_geo_countries_traffic": {
        "HK": 3.13,
        "IN": 6.71,
        "US": 30.39
      },
      "company_employees_by_department": {
        "employees_count_sales": 7,
        "employees_count_technical": 316
      },
      "criteria": {
        "Has lead gen experience": {
          "reasoning": "Profile mentions 5+ years in lead generation",
          "score": 4
        }
      },
      "match": 3
    }
  ],
  "meta": {
    "total": 12500,
    "results_count": 100,
    "credits_charged": 50,
    "remaining_balance": 950,
    "excluded_total": 37
  }
}