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,
    "revenue": {
      "min": 0,
      "max": 0
    },
    "naics_code": {
      "include": [],
      "exclude": []
    },
    "sic_code": {
      "include": [],
      "exclude": []
    },
    "web_traffic": {
      "min": 0,
      "max": 0
    },
    "ad_spend": {
      "min": 0,
      "max": 0
    },
    "total_funding": {
      "min": 0,
      "max": 0
    },
    "last_funding_amount": {
      "min": 0,
      "max": 0
    },
    "last_funding_year": {
      "min": 0,
      "max": 0
    },
    "last_funding_type": {
      "include": [],
      "exclude": []
    },
    "lead_investors": {
      "include": [],
      "exclude": []
    },
    "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": []
    },
    "education": {
      "include": [],
      "exclude": []
    }
  },
  "max_results": 3,
  "cursor": null
}
'
import requests

url = "https://api.blitz-api.ai/v2/search/people"

payload = {
    "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,
        "revenue": {
            "min": 0,
            "max": 0
        },
        "naics_code": {
            "include": [],
            "exclude": []
        },
        "sic_code": {
            "include": [],
            "exclude": []
        },
        "web_traffic": {
            "min": 0,
            "max": 0
        },
        "ad_spend": {
            "min": 0,
            "max": 0
        },
        "total_funding": {
            "min": 0,
            "max": 0
        },
        "last_funding_amount": {
            "min": 0,
            "max": 0
        },
        "last_funding_year": {
            "min": 0,
            "max": 0
        },
        "last_funding_type": {
            "include": [],
            "exclude": []
        },
        "lead_investors": {
            "include": [],
            "exclude": []
        },
        "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": []
        },
        "education": {
            "include": [],
            "exclude": []
        }
    },
    "max_results": 3,
    "cursor": None
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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,
      revenue: {min: 0, max: 0},
      naics_code: {include: [], exclude: []},
      sic_code: {include: [], exclude: []},
      web_traffic: {min: 0, max: 0},
      ad_spend: {min: 0, max: 0},
      total_funding: {min: 0, max: 0},
      last_funding_amount: {min: 0, max: 0},
      last_funding_year: {min: 0, max: 0},
      last_funding_type: {include: [], exclude: []},
      lead_investors: {include: [], exclude: []},
      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: []},
      education: {include: [], exclude: []}
    },
    max_results: 3,
    cursor: null
  })
};

fetch('https://api.blitz-api.ai/v2/search/people', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.blitz-api.ai/v2/search/people",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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,
        'revenue' => [
                'min' => 0,
                'max' => 0
        ],
        'naics_code' => [
                'include' => [
                                
                ],
                'exclude' => [
                                
                ]
        ],
        'sic_code' => [
                'include' => [
                                
                ],
                'exclude' => [
                                
                ]
        ],
        'web_traffic' => [
                'min' => 0,
                'max' => 0
        ],
        'ad_spend' => [
                'min' => 0,
                'max' => 0
        ],
        'total_funding' => [
                'min' => 0,
                'max' => 0
        ],
        'last_funding_amount' => [
                'min' => 0,
                'max' => 0
        ],
        'last_funding_year' => [
                'min' => 0,
                'max' => 0
        ],
        'last_funding_type' => [
                'include' => [
                                
                ],
                'exclude' => [
                                
                ]
        ],
        'lead_investors' => [
                'include' => [
                                
                ],
                'exclude' => [
                                
                ]
        ],
        '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' => [
                                
                ]
        ],
        'education' => [
                'include' => [
                                
                ],
                'exclude' => [
                                
                ]
        ]
    ],
    'max_results' => 3,
    'cursor' => null
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.blitz-api.ai/v2/search/people"

	payload := strings.NewReader("{\n  \"company\": {\n    \"linkedin_url\": [],\n    \"name\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"industry\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"type\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"employee_range\": [\n      \"1-10\",\n      \"11-50\",\n      \"51-200\",\n      \"201-500\",\n      \"501-1000\",\n      \"1001-5000\",\n      \"5001-10000\",\n      \"10001+\"\n    ],\n    \"employee_count\": {\n      \"min\": 1,\n      \"max\": 0\n    },\n    \"min_linkedin_followers\": 1,\n    \"revenue\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"naics_code\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"sic_code\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"web_traffic\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"ad_spend\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"total_funding\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"last_funding_amount\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"last_funding_year\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"last_funding_type\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"lead_investors\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"keywords\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"founded_year\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"hq\": {\n      \"city\": {\n        \"include\": [],\n        \"exclude\": []\n      },\n      \"country_code\": [],\n      \"continent\": [],\n      \"sales_region\": []\n    }\n  },\n  \"people\": {\n    \"job_title\": {\n      \"include_linkedin_headline\": false,\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"job_function\": [],\n    \"job_level\": [],\n    \"min_connections\": 500,\n    \"location\": {\n      \"city\": [],\n      \"country_code\": [\n        \"US\"\n      ],\n      \"continent\": [],\n      \"sales_region\": []\n    },\n    \"education\": {\n      \"include\": [],\n      \"exclude\": []\n    }\n  },\n  \"max_results\": 3,\n  \"cursor\": null\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.blitz-api.ai/v2/search/people")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"company\": {\n    \"linkedin_url\": [],\n    \"name\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"industry\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"type\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"employee_range\": [\n      \"1-10\",\n      \"11-50\",\n      \"51-200\",\n      \"201-500\",\n      \"501-1000\",\n      \"1001-5000\",\n      \"5001-10000\",\n      \"10001+\"\n    ],\n    \"employee_count\": {\n      \"min\": 1,\n      \"max\": 0\n    },\n    \"min_linkedin_followers\": 1,\n    \"revenue\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"naics_code\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"sic_code\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"web_traffic\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"ad_spend\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"total_funding\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"last_funding_amount\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"last_funding_year\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"last_funding_type\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"lead_investors\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"keywords\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"founded_year\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"hq\": {\n      \"city\": {\n        \"include\": [],\n        \"exclude\": []\n      },\n      \"country_code\": [],\n      \"continent\": [],\n      \"sales_region\": []\n    }\n  },\n  \"people\": {\n    \"job_title\": {\n      \"include_linkedin_headline\": false,\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"job_function\": [],\n    \"job_level\": [],\n    \"min_connections\": 500,\n    \"location\": {\n      \"city\": [],\n      \"country_code\": [\n        \"US\"\n      ],\n      \"continent\": [],\n      \"sales_region\": []\n    },\n    \"education\": {\n      \"include\": [],\n      \"exclude\": []\n    }\n  },\n  \"max_results\": 3,\n  \"cursor\": null\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.blitz-api.ai/v2/search/people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"company\": {\n    \"linkedin_url\": [],\n    \"name\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"industry\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"type\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"employee_range\": [\n      \"1-10\",\n      \"11-50\",\n      \"51-200\",\n      \"201-500\",\n      \"501-1000\",\n      \"1001-5000\",\n      \"5001-10000\",\n      \"10001+\"\n    ],\n    \"employee_count\": {\n      \"min\": 1,\n      \"max\": 0\n    },\n    \"min_linkedin_followers\": 1,\n    \"revenue\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"naics_code\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"sic_code\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"web_traffic\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"ad_spend\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"total_funding\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"last_funding_amount\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"last_funding_year\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"last_funding_type\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"lead_investors\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"keywords\": {\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"founded_year\": {\n      \"min\": 0,\n      \"max\": 0\n    },\n    \"hq\": {\n      \"city\": {\n        \"include\": [],\n        \"exclude\": []\n      },\n      \"country_code\": [],\n      \"continent\": [],\n      \"sales_region\": []\n    }\n  },\n  \"people\": {\n    \"job_title\": {\n      \"include_linkedin_headline\": false,\n      \"include\": [],\n      \"exclude\": []\n    },\n    \"job_function\": [],\n    \"job_level\": [],\n    \"min_connections\": 500,\n    \"location\": {\n      \"city\": [],\n      \"country_code\": [\n        \"US\"\n      ],\n      \"continent\": [],\n      \"sales_region\": []\n    },\n    \"education\": {\n      \"include\": [],\n      \"exclude\": []\n    }\n  },\n  \"max_results\": 3,\n  \"cursor\": null\n}"

response = http.request(request)
puts response.read_body
{
  "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"
}
{
  "success": true,
  "message": "<string>"
}
{
  "success": true,
  "message": "<string>"
}
{
  "success": true,
  "message": "<string>"
}
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.