Skip to main content
POST
/
v2
/
search
/
people
Find People
curl --request POST \
  --url https://api.blitz-api.ai/v2/search/people \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "company": {
    "linkedin_url": [],
    "name": {
      "include": [],
      "exclude": []
    },
    "industry": {
      "include": [],
      "exclude": []
    },
    "type": {
      "include": [],
      "exclude": []
    },
    "employee_range": [
      "1-10",
      "11-50",
      "51-200",
      "201-500",
      "501-1000",
      "1001-5000",
      "5001-10000",
      "10001+"
    ],
    "employee_count": {
      "min": 1,
      "max": 0
    },
    "min_linkedin_followers": 1,
    "keywords": {
      "include": [],
      "exclude": []
    },
    "founded_year": {
      "min": 0,
      "max": 0
    },
    "hq": {
      "city": {
        "include": [],
        "exclude": []
      },
      "country_code": [],
      "continent": [],
      "sales_region": []
    }
  },
  "people": {
    "job_title": {
      "include_linkedin_headline": false,
      "include": [],
      "exclude": []
    },
    "job_function": [],
    "job_level": [],
    "min_connections": 500,
    "location": {
      "city": [],
      "country_code": [
        "US"
      ],
      "continent": [],
      "sales_region": []
    }
  },
  "max_results": 3,
  "cursor": null
}
'
{
  "total_results": 14337505,
  "results": [
    {
      "first_name": "Roman",
      "last_name": "Orunbayev",
      "full_name": "Roman Orunbayev",
      "nickname": null,
      "civility_title": null,
      "headline": "Happily employed by Google🚀",
      "about_me": "Linux Administrator with over 5 years of experience in varied industries…",
      "location": {
        "city": "Owasso",
        "state_code": "OK",
        "country_code": "US",
        "continent": "North America"
      },
      "linkedin_url": "https://www.linkedin.com/in/orro",
      "connections_count": 500,
      "profile_picture_url": "https://media.licdn.com/dms/image/v2/D4E03AQEMu2e6LE7OIg/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1723677210429",
      "experiences": [
        {
          "company_name": "Google",
          "job_title": null,
          "company_linkedin_url": "https://www.linkedin.com/company/google",
          "company_linkedin_id": "c346a3f2-6914-51e8-bb11-7da93440a3c0",
          "company_domain": "google.com",
          "job_description": null,
          "job_start_date": null,
          "job_end_date": null,
          "job_is_current": true,
          "job_location": {
            "city": null,
            "state_code": null,
            "country_code": null
          }
        }
      ],
      "education": [],
      "skills": [],
      "certifications": [
        {
          "authority": "ZiyoTek Institute of Technology",
          "name": "DevOps Engineer Diploma",
          "url": "https://www.credly.com/badges/3708542b-26a2-4845-bd42-932727a1db9e"
        },
        {
          "authority": "Red Hat",
          "name": "Red Hat Certified System Administrator (RHCSA)",
          "url": "https://rhtapps.redhat.com/verify"
        }
      ]
    },
    {
      "first_name": "Beulah",
      "last_name": "Lee",
      "full_name": "Beulah Lee",
      "nickname": null,
      "civility_title": null,
      "headline": "Software Engineer at Google",
      "about_me": "I am a highly motivated and self-disciplined software engineer with a strong foundation…",
      "location": {
        "city": "Sunnyvale",
        "state_code": "CA",
        "country_code": "US",
        "continent": "North America"
      },
      "linkedin_url": "https://www.linkedin.com/in/beulah-lee",
      "connections_count": 500,
      "profile_picture_url": "https://media.licdn.com/dms/image/v2/D5603AQH3qwMwMK2t6Q/profile-displayphoto-scale_200_200/B56ZpUud.kIYAY-/0/1762358059936",
      "experiences": [
        {
          "company_name": "Google",
          "job_title": "Software Engineer",
          "company_linkedin_url": "https://www.linkedin.com/company/google",
          "company_linkedin_id": "c346a3f2-6914-51e8-bb11-7da93440a3c0",
          "company_domain": "google.com",
          "job_description": "Google Workspace",
          "job_start_date": "2025-04-01",
          "job_end_date": null,
          "job_is_current": true,
          "job_location": {
            "city": "Sunnyvale",
            "state_code": "CA",
            "country_code": "US"
          }
        }
      ],
      "education": [
        {
          "degree": "Bachelor's degree",
          "start_date": "2019-01-01",
          "end_date": "2023-01-01"
        },
        {
          "degree": "Leadership Certificate",
          "start_date": "2019-01-01",
          "end_date": "2021-01-01"
        },
        {
          "degree": "Minor",
          "start_date": "2022-01-01",
          "end_date": "2023-01-01"
        }
      ],
      "skills": [],
      "certifications": [
        {
          "authority": "Google",
          "name": "Google Cloud Cybersecurity Certificate",
          "url": "https://www.credly.com/badges/755d5778-3462-4f74-bbbb-aa2c6b69be2c/public_url"
        },
        {
          "authority": "Amazon Web Services (AWS)",
          "name": "AWS Certified Cloud Practitioner Certification",
          "url": "https://www.credly.com/badges/97bf3cd5-94a1-4d79-a672-547bb99f6a48/public_url"
        },
        {
          "authority": "Discover Financial Services",
          "name": "Certified Application Security Professional"
        }
      ]
    },
    {
      "first_name": "Tran",
      "last_name": "Hang",
      "full_name": "Tran Hang",
      "nickname": null,
      "civility_title": null,
      "headline": "Director Global Product Solutions: Performance Max , Lead Generation Solutions, Vertical Solutions (Travel, Local, Autos, etc).",
      "about_me": "Professional with: Extensive experience in product strategy, go-to-market operations…",
      "location": {
        "city": null,
        "state_code": null,
        "country_code": "US",
        "continent": "North America"
      },
      "linkedin_url": "https://www.linkedin.com/in/tranhang",
      "connections_count": 500,
      "profile_picture_url": "https://media.licdn.com/dms/image/v2/C4E03AQEiQYQrYYmPwg/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1553146573521",
      "experiences": [
        {
          "company_name": "Google",
          "job_title": "Director Global Product Solutions Performance Max, Lead Gen, Local, Travel",
          "company_linkedin_url": "https://www.linkedin.com/company/google",
          "company_linkedin_id": "c346a3f2-6914-51e8-bb11-7da93440a3c0",
          "company_domain": "google.com",
          "job_description": null,
          "job_start_date": "2025-05-01",
          "job_end_date": null,
          "job_is_current": true,
          "job_location": {
            "city": null,
            "state_code": null,
            "country_code": null
          }
        }
      ],
      "education": [
        {
          "degree": "Master of Business Administration - MBA"
        },
        {
          "degree": "Bachelor of Arts"
        },
        {
          "degree": "Bachelor's degree",
          "start_date": "1996-01-01",
          "end_date": "2000-01-01"
        }
      ],
      "skills": [
        "sem",
        "online marketing",
        "marketing strategy"
      ],
      "certifications": []
    }
  ],
  "results_length": 3,
  "max_results": 3,
  "cursor": "eyJzIjpbNTAwLDQwNTE3ODE4LDMzMTk2MV0sIm8iOjN9.p_8tss535KvrL-hmwsnW9JfW7rHHbt2NLQuVODC3bjw"
}

Documentation Index

Fetch the complete documentation index at: https://docs.blitz-api.ai/llms.txt

Use this file to discover all available pages before exploring further.

Agents & LLMs: a Markdown version of this page is available by appending .md to the URL, and the full documentation index is at llms.txt.
Cost: 1 credit per person returned on Trial Plan
Free on the Unlimited plan
Job title - exact match: wrap a value in square brackets to switch from keyword matching to exact matching. "[CEO]" matches only CEO/ceo/Céo; "CEO" (no brackets) is FTS (full text search) and also matches Co-CEO, CEO Office. Mixed arrays are allowed: ["[CEO]", "Founder"]. Full rules.
Search decision-makers across many companies in a single call. Combine company-level filters (industry, size, HQ) with person-level filters (job title, level, location).
Pagination is cursor-based. Pass the cursor returned by each response back into the next request. Stop when cursor is null. Pagination is limited to maximum to 50k results.
Filter logic: All filters combine with AND. Multiple values within a single filter combine with OR — e.g. two industries in company.industry.include returns people at companies in either industry.

Find People guide

Walk-through of combining company and person filters to build an ICP list end-to-end.

Authorizations

​
x-api-key
string
header
required

Your Blitz API Key. Get one from https://app.blitz-api.ai

Body

application/json
​
company
object

Company search criteria

​
people
object

People search criteria for company matching

​
max_results
number
default:10

Maximum number of results to return

Required range: 1 <= x <= 50
Example:

10

​
cursor
string | null

Cursor to paginate through the results

Minimum string length: 3
Example:

null

Response

OK

The response is of type object.