Search People
curl --request POST \
--url https://api.aisa.one/apis/v1/prospeo/search-people \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://api.aisa.one/apis/v1/prospeo/search-people"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.aisa.one/apis/v1/prospeo/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.aisa.one/apis/v1/prospeo/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([
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.aisa.one/apis/v1/prospeo/search-people"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.aisa.one/apis/v1/prospeo/search-people")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/prospeo/search-people")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"
response = http.request(request)
puts response.read_body{
"free": true,
"results": [
{
"person": {
"email": {
"email": "<string>",
"status": "<string>",
"revealed": true,
"email_mx_provider": "<string>",
"verification_method": "<string>"
},
"mobile": {
"mobile": "<string>",
"status": "<string>",
"revealed": true,
"mobile_country": "<string>",
"mobile_national": "<string>",
"mobile_country_code": "<string>",
"mobile_international": "<string>"
},
"skills": [
"<string>"
],
"headline": "<string>",
"location": {
"city": "<string>",
"state": "<string>",
"country": "<string>",
"time_zone": "<string>",
"country_code": "<string>",
"time_zone_offset": 123
},
"full_name": "<string>",
"last_name": "<string>",
"person_id": "<string>",
"first_name": "<string>",
"job_history": [
{
"title": "<string>",
"current": true,
"job_key": "<string>",
"end_year": 123,
"logo_url": "<string>",
"end_month": 123,
"seniority": "<string>",
"company_id": "<string>",
"start_year": 123,
"departments": [
"<string>"
],
"start_month": 123,
"company_name": "<string>",
"duration_in_months": 123
}
],
"linkedin_url": "<string>",
"current_job_key": "<string>",
"current_job_title": "<string>",
"linkedin_member_id": "<string>",
"last_job_change_detected_at": "<string>"
},
"company": {
"name": "<string>",
"type": "<string>",
"domain": "<string>",
"founded": 123,
"funding": {
"count": 123,
"total_funding": 123,
"funding_events": [
{
"link": "<string>",
"stage": "<string>",
"amount": 123,
"raised_at": "<string>",
"amount_printed": "<string>"
}
],
"latest_funding_date": "<string>",
"latest_funding_stage": "<string>",
"total_funding_printed": "<string>"
},
"website": "<string>",
"industry": "<string>",
"keywords": [
"<string>"
],
"location": {
"city": "<string>",
"state": "<string>",
"country": "<string>",
"raw_address": "<string>",
"country_code": "<string>"
},
"logo_url": "<string>",
"phone_hq": {
"phone_hq": "<string>",
"phone_hq_country": "<string>",
"phone_hq_national": "<string>",
"phone_hq_country_code": "<string>",
"phone_hq_international": "<string>"
},
"sic_codes": [
"<string>"
],
"attributes": {
"is_b2b": true,
"has_demo": true,
"has_pricing": true,
"has_free_trial": true,
"has_mobile_apps": true,
"has_downloadable": true,
"has_online_reviews": true
},
"company_id": "<string>",
"email_tech": {
"domain": "<string>",
"mx_provider": "<string>"
},
"technology": {
"count": 123,
"technology_list": [
{
"name": "<string>",
"category": "<string>"
}
],
"technology_names": [
"<string>"
]
},
"description": "<string>",
"linkedin_id": "<string>",
"naics_codes": [
"<string>"
],
"twitter_url": "<string>",
"youtube_url": "<string>",
"facebook_url": "<string>",
"job_postings": {
"active_count": 123,
"active_titles": [
"<string>"
]
},
"linkedin_url": "<string>",
"instagram_url": "<string>",
"revenue_range": {
"max": 123,
"min": 123
},
"crunchbase_url": "<string>",
"description_ai": "<string>",
"employee_count": 123,
"employee_range": "<string>",
"other_websites": [
"<string>"
],
"description_seo": "<string>",
"revenue_range_printed": "<string>",
"employee_count_on_prospeo": 123
}
}
],
"has_more": true,
"pagination": {
"per_page": 123,
"total_page": 123,
"total_count": 123,
"current_page": 123
},
"next_cursor": "<string>"
}Prospeo
Search People
<!-- aisa-pricing:start -->
Usage-based billing; Default request estimate: $0.0243 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->
POST
https://api.aisa.one
/
apis
/
v1
/
prospeo
/
search-people
Search People
curl --request POST \
--url https://api.aisa.one/apis/v1/prospeo/search-people \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://api.aisa.one/apis/v1/prospeo/search-people"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.aisa.one/apis/v1/prospeo/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.aisa.one/apis/v1/prospeo/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([
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.aisa.one/apis/v1/prospeo/search-people"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.aisa.one/apis/v1/prospeo/search-people")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/prospeo/search-people")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"
response = http.request(request)
puts response.read_body{
"free": true,
"results": [
{
"person": {
"email": {
"email": "<string>",
"status": "<string>",
"revealed": true,
"email_mx_provider": "<string>",
"verification_method": "<string>"
},
"mobile": {
"mobile": "<string>",
"status": "<string>",
"revealed": true,
"mobile_country": "<string>",
"mobile_national": "<string>",
"mobile_country_code": "<string>",
"mobile_international": "<string>"
},
"skills": [
"<string>"
],
"headline": "<string>",
"location": {
"city": "<string>",
"state": "<string>",
"country": "<string>",
"time_zone": "<string>",
"country_code": "<string>",
"time_zone_offset": 123
},
"full_name": "<string>",
"last_name": "<string>",
"person_id": "<string>",
"first_name": "<string>",
"job_history": [
{
"title": "<string>",
"current": true,
"job_key": "<string>",
"end_year": 123,
"logo_url": "<string>",
"end_month": 123,
"seniority": "<string>",
"company_id": "<string>",
"start_year": 123,
"departments": [
"<string>"
],
"start_month": 123,
"company_name": "<string>",
"duration_in_months": 123
}
],
"linkedin_url": "<string>",
"current_job_key": "<string>",
"current_job_title": "<string>",
"linkedin_member_id": "<string>",
"last_job_change_detected_at": "<string>"
},
"company": {
"name": "<string>",
"type": "<string>",
"domain": "<string>",
"founded": 123,
"funding": {
"count": 123,
"total_funding": 123,
"funding_events": [
{
"link": "<string>",
"stage": "<string>",
"amount": 123,
"raised_at": "<string>",
"amount_printed": "<string>"
}
],
"latest_funding_date": "<string>",
"latest_funding_stage": "<string>",
"total_funding_printed": "<string>"
},
"website": "<string>",
"industry": "<string>",
"keywords": [
"<string>"
],
"location": {
"city": "<string>",
"state": "<string>",
"country": "<string>",
"raw_address": "<string>",
"country_code": "<string>"
},
"logo_url": "<string>",
"phone_hq": {
"phone_hq": "<string>",
"phone_hq_country": "<string>",
"phone_hq_national": "<string>",
"phone_hq_country_code": "<string>",
"phone_hq_international": "<string>"
},
"sic_codes": [
"<string>"
],
"attributes": {
"is_b2b": true,
"has_demo": true,
"has_pricing": true,
"has_free_trial": true,
"has_mobile_apps": true,
"has_downloadable": true,
"has_online_reviews": true
},
"company_id": "<string>",
"email_tech": {
"domain": "<string>",
"mx_provider": "<string>"
},
"technology": {
"count": 123,
"technology_list": [
{
"name": "<string>",
"category": "<string>"
}
],
"technology_names": [
"<string>"
]
},
"description": "<string>",
"linkedin_id": "<string>",
"naics_codes": [
"<string>"
],
"twitter_url": "<string>",
"youtube_url": "<string>",
"facebook_url": "<string>",
"job_postings": {
"active_count": 123,
"active_titles": [
"<string>"
]
},
"linkedin_url": "<string>",
"instagram_url": "<string>",
"revenue_range": {
"max": 123,
"min": 123
},
"crunchbase_url": "<string>",
"description_ai": "<string>",
"employee_count": 123,
"employee_range": "<string>",
"other_websites": [
"<string>"
],
"description_seo": "<string>",
"revenue_range_printed": "<string>",
"employee_count_on_prospeo": 123
}
}
],
"has_more": true,
"pagination": {
"per_page": 123,
"total_page": 123,
"total_count": 123,
"current_page": 123
},
"next_cursor": "<string>"
}Request contract
- Method and path: POST /apis/v1/prospeo/search-people
- Availability: enabled
- Request URL template:
https://api.aisa.one/apis/v1/prospeo/search-people - Runtime facts: 14747b6d3b7c1fb8f4ed610011f8f5654aa07f8d884665f33860fa90664909fa
{
"operationId": "prospeo.search-people",
"method": "POST",
"path": "/apis/v1/prospeo/search-people",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"required": false,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"filters": {
"type": "object",
"examples": [
{
"company": {
"websites": {
"include": [
"openai.com"
]
}
}
}
],
"properties": {
"company": {
"type": "object",
"properties": {
"names": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"description": "Values to exclude, up to 500."
},
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"description": "Values to include, up to 500."
}
},
"description": "Company names to include or exclude.",
"additionalProperties": false
},
"websites": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"description": "Values to exclude, up to 500."
},
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"description": "Values to include, up to 500."
}
},
"description": "Root company websites or domains to include or exclude.",
"additionalProperties": false
},
"company_oids": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5000,
"description": "Prospeo company IDs to exclude, up to 5,000."
},
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5000,
"description": "Prospeo company IDs to include, up to 5,000."
}
},
"description": "Prospeo company IDs to include or exclude. Valid for person search, up to 5,000 values overall.",
"additionalProperties": false
}
},
"description": "Company names, websites, or IDs. Company IDs are supported in person search.",
"additionalProperties": false
},
"company_icp": {
"type": "object",
"properties": {
"industries": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "ICP industries, up to 10. GROWTH+ only."
},
"departments": {
"type": "object",
"properties": {
"other": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5,
"description": "Other departments, up to 5. GROWTH+ only."
},
"include": {
"type": "array",
"items": {
"enum": [
"Engineering",
"Sales",
"Marketing",
"Finance",
"HR",
"Operations",
"IT",
"Legal",
"Customer Success",
"Procurement",
"Data",
"Security",
"Design",
"SMB Owners",
"Consumers"
],
"type": "string"
},
"maxItems": 15,
"description": "Canonical departments, up to 15. GROWTH+ only."
},
"match_mode": {
"enum": [
"any",
"all"
],
"type": "string",
"description": "Department match mode. GROWTH+ only."
}
},
"description": "ICP department criteria. GROWTH+ only.",
"additionalProperties": false
},
"company_sizes": {
"type": "array",
"items": {
"enum": [
"micro",
"smb",
"midmarket",
"enterprise",
"large_enterprise"
],
"type": "string"
},
"description": "ICP company sizes. GROWTH+ only."
},
"titles_exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "ICP titles to exclude, up to 20. GROWTH+ only."
},
"titles_include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "ICP titles to include, up to 20. GROWTH+ only."
},
"geographic_scope": {
"enum": [
"single_country",
"multi_country"
],
"type": "string",
"description": "ICP geographic scope. GROWTH+ only."
},
"geographic_markets": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "ICP geographic markets, up to 10. GROWTH+ only."
}
},
"description": "Ideal-customer-profile criteria. GROWTH+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"person_name": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"description": "Names to exclude, up to 500."
},
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"description": "Names to include, up to 500."
},
"person_oids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"description": "Prospeo person IDs, up to 50."
}
},
"description": "Strict person names or IDs. Mutually exclusive with person_search.",
"additionalProperties": false
},
"company_news": {
"type": "object",
"properties": {
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "News keywords, up to 20."
},
"categories": {
"type": "array",
"items": {
"enum": [
"Funding & Investment",
"Mergers & Acquisitions",
"Product Launch",
"Partnership",
"Expansion",
"Layoffs & Restructuring",
"IPO",
"Leadership Change",
"Legal & Regulatory",
"Awards & Recognition"
],
"type": "string"
},
"maxItems": 10,
"description": "News categories, up to 10."
},
"timeframe_days": {
"enum": [
60,
90,
180,
365
],
"type": "integer",
"description": "News lookback window in days."
}
},
"description": "Company-news criteria.",
"additionalProperties": false
},
"company_sics": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 100,
"description": "Codes to exclude, up to 100."
},
"include": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 100,
"description": "Codes to include, up to 100."
}
},
"description": "SIC codes resolved through SEARCH_SUGGESTIONS.",
"additionalProperties": false
},
"company_type": {
"anyOf": [
{
"type": "object",
"title": "CompanyTypeDetails",
"properties": {
"status": {
"anyOf": [
{
"enum": [
"Private",
"Public",
"Non Profit",
"Other"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Status",
"default": null,
"description": "Company ownership status."
},
"subtypes": {
"anyOf": [
{
"type": "object",
"title": "CompanySubtypeFilter",
"properties": {
"exclude": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"SaaS",
"Marketplace",
"E-commerce",
"Agency",
"Consulting",
"Manufacturing",
"Media/Publisher",
"Education",
"Non-Profit",
"Government",
"FinTech",
"HealthTech",
"AI/ML",
"Hardware",
"Professional Services",
"Platform",
"Data/Analytics",
"Franchise",
"Logistics",
"Real Estate",
"Legal",
"Insurance",
"Retail",
"Hospitality",
"Food & Beverage",
"Construction",
"Telecommunications"
],
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Exclude",
"default": null,
"description": "Company subtypes to exclude."
},
"include": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"SaaS",
"Marketplace",
"E-commerce",
"Agency",
"Consulting",
"Manufacturing",
"Media/Publisher",
"Education",
"Non-Profit",
"Government",
"FinTech",
"HealthTech",
"AI/ML",
"Hardware",
"Professional Services",
"Platform",
"Data/Analytics",
"Franchise",
"Logistics",
"Real Estate",
"Legal",
"Insurance",
"Retail",
"Hospitality",
"Food & Beverage",
"Construction",
"Telecommunications"
],
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Include",
"default": null,
"description": "Company subtypes to include."
}
}
},
{
"type": "null"
}
],
"default": null,
"description": "Company subtypes to include or exclude."
},
"is_retail": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Retail",
"default": null,
"description": "Filter retail companies."
},
"is_mainly_ai": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Mainly Ai",
"default": null,
"description": "Filter primarily AI companies."
},
"is_sales_led": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Sales Led",
"default": null,
"description": "Filter sales-led companies."
},
"has_free_tier": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Has Free Tier",
"default": null,
"description": "Filter by free-tier availability."
},
"is_self_serve": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Self Serve",
"default": null,
"description": "Filter self-serve companies."
},
"multi_product": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Multi Product",
"default": null,
"description": "Filter multi-product companies."
},
"business_model": {
"anyOf": [
{
"enum": [
"b2b",
"b2c",
"b2b2c",
"d2c",
"marketplace",
"franchise",
"non_profit",
"government"
],
"type": "string"
},
{
"type": "array",
"items": {
"enum": [
"b2b",
"b2c",
"b2b2c",
"d2c",
"marketplace",
"franchise",
"non_profit",
"government"
],
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Business Model",
"default": null,
"description": "Business model or models."
},
"is_marketplace": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Marketplace",
"default": null,
"description": "Filter marketplace companies."
},
"has_subscription": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Has Subscription",
"default": null,
"description": "Filter by subscription offering."
},
"is_mainly_crypto": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Mainly Crypto",
"default": null,
"description": "Filter primarily crypto companies."
},
"has_usage_pricing": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Has Usage Pricing",
"default": null,
"description": "Filter by usage-based pricing."
},
"has_public_pricing": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Has Public Pricing",
"default": null,
"description": "Filter by public pricing."
},
"has_enterprise_plan": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Has Enterprise Plan",
"default": null,
"description": "Filter by enterprise-plan availability."
}
}
},
{
"enum": [
"Private",
"Public",
"Non Profit",
"Other"
],
"type": "string"
}
],
"description": "Company ownership status or detailed company-type facets. Available on FREE."
},
"company_naics": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 100,
"description": "Codes to exclude, up to 100."
},
"include": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 100,
"description": "Codes to include, up to 100."
}
},
"description": "NAICS codes resolved through SEARCH_SUGGESTIONS.",
"additionalProperties": false
},
"person_search": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"description": "Broad person terms to exclude, up to 500; each 1-100 characters."
},
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"description": "Broad person terms to include, up to 500; each 1-100 characters."
},
"match_mode": {
"enum": [
"SMART",
"STRICT"
],
"type": "string",
"description": "Broad person-term match mode."
}
},
"description": "Broad person terms. Mutually exclusive with person_name.",
"additionalProperties": false
},
"company_awards": {
"type": "object",
"required": [
"include"
],
"properties": {
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"description": "Awards to include, 1-50. GROWTH+ only."
},
"match_mode": {
"enum": [
"EXACT",
"CONTAINS"
],
"type": "string",
"description": "Award match mode. GROWTH+ only."
}
},
"description": "Company awards. GROWTH+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"company_intent": {
"type": "object",
"required": [
"topic_ids"
],
"properties": {
"topic_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 30,
"minItems": 1,
"description": "Account-specific dashboard topic IDs, 1-30; this API cannot discover them."
},
"early_research": {
"type": "boolean",
"description": "Require early research intent."
},
"active_research": {
"type": "boolean",
"description": "Require active research intent."
},
"in_depth_research": {
"type": "boolean",
"description": "Require in-depth research intent."
}
},
"description": "Intent topics from the Prospeo dashboard; topic IDs cannot be discovered through this API.",
"additionalProperties": false
},
"company_founded": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"minimum": 1900,
"description": "Latest founding year."
},
"min": {
"type": "integer",
"minimum": 1900,
"description": "Earliest founding year."
},
"include_unknown_founded": {
"type": "boolean",
"description": "Include companies with unknown founding year."
}
},
"description": "Founding-year range.",
"additionalProperties": false
},
"company_funding": {
"type": "object",
"properties": {
"stage": {
"type": "array",
"items": {
"enum": [
"Angel",
"Convertible note",
"Corporate round",
"Debt financing",
"Equity crowdfunding",
"Grant",
"Initial coin offering",
"Non equity assistance",
"Post IPO debt",
"Post IPO equity",
"Post IPO secondary",
"Pre seed",
"Private equity",
"Product crowdfunding",
"Secondary market",
"Seed",
"Series A",
"Series B",
"Series C",
"Series D",
"Series E-J",
"Series unknown",
"Undisclosed"
],
"type": "string"
},
"maxItems": 500,
"description": "Funding stages, up to 500. STARTER+ only."
},
"investors": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "Investors, up to 10. STARTER+ only."
},
"funding_date": {
"enum": [
30,
60,
90,
180,
270,
365
],
"type": "integer",
"description": "Days since funding. STARTER+ only."
},
"last_funding": {
"type": "object",
"properties": {
"max": {
"enum": [
"<100K",
"100K",
"500K",
"1M",
"5M",
"10M",
"25M",
"50M",
"100M",
"250M",
"500M",
"1B",
"5B",
"10B+"
],
"type": "string",
"description": "Inclusive maximum revenue band."
},
"min": {
"enum": [
"<100K",
"100K",
"500K",
"1M",
"5M",
"10M",
"25M",
"50M",
"100M",
"250M",
"500M",
"1B",
"5B",
"10B+"
],
"type": "string",
"description": "Inclusive minimum revenue band."
}
},
"description": "Latest funding amount range. STARTER+ only.",
"additionalProperties": false
},
"total_funding": {
"type": "object",
"properties": {
"max": {
"enum": [
"<100K",
"100K",
"500K",
"1M",
"5M",
"10M",
"25M",
"50M",
"100M",
"250M",
"500M",
"1B",
"5B",
"10B+"
],
"type": "string",
"description": "Inclusive maximum revenue band."
},
"min": {
"enum": [
"<100K",
"100K",
"500K",
"1M",
"5M",
"10M",
"25M",
"50M",
"100M",
"250M",
"500M",
"1B",
"5B",
"10B+"
],
"type": "string",
"description": "Inclusive minimum revenue band."
}
},
"description": "Total funding amount range. STARTER+ only.",
"additionalProperties": false
},
"accelerator_name": {
"type": "string",
"description": "Accelerator name. STARTER+ only."
},
"was_in_accelerator": {
"type": "boolean",
"description": "Filter accelerator participation. STARTER+ only."
}
},
"description": "Funding criteria. STARTER+ only; FREE returns PLAN_REQUIRED.",
"additionalProperties": false
},
"company_revenue": {
"type": "object",
"properties": {
"max": {
"enum": [
"<100K",
"100K",
"500K",
"1M",
"5M",
"10M",
"25M",
"50M",
"100M",
"250M",
"500M",
"1B",
"5B",
"10B+"
],
"type": "string",
"description": "Maximum revenue bucket. STARTER+ only."
},
"min": {
"enum": [
"<100K",
"100K",
"500K",
"1M",
"5M",
"10M",
"25M",
"50M",
"100M",
"250M",
"500M",
"1B",
"5B",
"10B+"
],
"type": "string",
"description": "Minimum revenue bucket. STARTER+ only."
},
"include_unknown_revenue": {
"type": "boolean",
"description": "Include companies with unknown revenue. STARTER+ only."
}
},
"description": "Revenue criteria. STARTER+ only; FREE returns PLAN_REQUIRED.",
"additionalProperties": false
},
"company_industry": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"description": "Values to exclude, up to 500."
},
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"description": "Values to include, up to 500."
}
},
"description": "Canonical company industries.",
"additionalProperties": false
},
"company_keywords": {
"type": "object",
"required": [
"include"
],
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Keywords to exclude, up to 20."
},
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"description": "Keywords to include; 1-20 are required."
},
"sources": {
"type": "array",
"items": {
"enum": [
"specialties",
"social_media_description",
"seo_description",
"ai_description",
"products_services",
"website_pages"
],
"type": "string"
},
"description": "Company text sources to search."
},
"include_all": {
"type": "boolean",
"description": "Require all included keywords instead of any keyword."
},
"search_everywhere": {
"type": "boolean",
"description": "Search all supported company text sources."
}
},
"description": "Company keyword criteria.",
"additionalProperties": false
},
"person_education": {
"type": "object",
"properties": {
"degrees": {
"type": "array",
"items": {
"enum": [
"high school",
"associate",
"bachelors",
"masters",
"mba",
"phd",
"professional",
"diploma",
"vocational",
"other"
],
"type": "string"
},
"description": "Degree levels. GROWTH+ only."
},
"schools": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Schools, up to 20. GROWTH+ only."
},
"graduated_max": {
"type": "integer",
"minimum": 1950,
"description": "Latest graduation year. GROWTH+ only."
},
"graduated_min": {
"type": "integer",
"minimum": 1950,
"description": "Earliest graduation year. GROWTH+ only."
},
"fields_of_study": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Fields of study, up to 20. GROWTH+ only."
}
},
"description": "Education criteria. GROWTH+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"person_job_title": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"description": "Current job titles to exclude, up to 100."
},
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"description": "Current job titles to include, up to 100."
},
"match_mode": {
"enum": [
"CONTAINS",
"EXACT",
"SIMILAR"
],
"type": "string",
"description": "Job-title match mode."
},
"boolean_search": {
"type": "string",
"description": "Boolean current-title query; cannot combine with include or exclude."
},
"smart_intensity": {
"enum": [
"LOOSE",
"NORMAL",
"STRICT"
],
"type": "string",
"description": "Similarity intensity for smart title matching."
}
},
"description": "Current job-title criteria.",
"additionalProperties": false
},
"person_seniority": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"enum": [
"C-Suite",
"Director",
"Entry",
"Founder/Owner",
"Head",
"Intern",
"Manager",
"Partner",
"Senior",
"Vice President"
],
"type": "string"
},
"maxItems": 11,
"description": "Canonical seniorities to exclude, up to 11."
},
"include": {
"type": "array",
"items": {
"enum": [
"C-Suite",
"Director",
"Entry",
"Founder/Owner",
"Head",
"Intern",
"Manager",
"Partner",
"Senior",
"Vice President"
],
"type": "string"
},
"maxItems": 11,
"description": "Canonical seniorities to include, up to 11."
}
},
"description": "Canonical seniorities, at most 11; include and exclude are mutually exclusive.",
"additionalProperties": false
},
"company_key_execs": {
"type": "object",
"required": [
"event_types"
],
"properties": {
"event_types": {
"type": "array",
"items": {
"enum": [
"CEO Departed",
"CEO Appointed",
"CTO Departed",
"CTO Appointed",
"CFO Departed",
"CFO Appointed",
"COO Departed",
"COO Appointed",
"CMO Departed",
"CMO Appointed",
"CRO Departed",
"CRO Appointed",
"VP of Sales Departed",
"VP of Sales Appointed",
"VP of Marketing Departed",
"VP of Marketing Appointed",
"VP of Engineering Departed",
"VP of Engineering Appointed",
"Any C-Level Departed",
"Any C-Level Appointed",
"Any VP Departed",
"Any VP Appointed",
"Any Director Departed",
"Any Director Appointed"
],
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"description": "Executive event types, 1-10. PRO+ only."
},
"timeframe_days": {
"enum": [
60,
90,
180,
365
],
"type": "integer",
"description": "Executive-event lookback in days. PRO+ only."
}
},
"description": "Key-executive events. PRO+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"company_lookalike": {
"type": "object",
"properties": {
"domain": {
"type": "string",
"description": "Seed company domain. STARTER+ only."
},
"icp_text": {
"type": "string",
"maxLength": 5000,
"description": "Ideal-customer description, up to 5,000 characters. STARTER+ only."
},
"match_all": {
"type": "boolean",
"description": "Require all lookalike dimensions. STARTER+ only."
},
"person_oids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "Seed person IDs, up to 10; valid for person search. STARTER+ only."
},
"company_oids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "Seed company IDs, up to 10. STARTER+ only."
},
"minimum_tier": {
"enum": [
"T1",
"T2",
"T3"
],
"type": "string",
"description": "Minimum match tier. STARTER+ only."
},
"same_language": {
"type": "boolean",
"description": "Require the same language. STARTER+ only."
}
},
"description": "Exactly one lookalike seed mode. STARTER+ only; person_oids are valid in this person search.",
"additionalProperties": false
},
"person_department": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"enum": [
"C-Suite",
"Chief Executive",
"Finance Executive",
"Founder",
"Human Resources Executive",
"Information Technology Executive",
"Legal Executive",
"Marketing Executive",
"Medical & Health Executive",
"Operations Executive",
"Sales Leader",
"Product",
"Product Development",
"Product Management",
"Other Product",
"Engineering & Technical",
"Artificial Intelligence / Machine Learning",
"Bioengineering",
"Biometrics",
"Business Intelligence",
"Chemical Engineering",
"Data Science & Analysis",
"DevOps",
"Digital Transformation",
"Emerging Technology / Innovation",
"Industrial Engineering",
"Mechanic",
"Mobile Development",
"Project Management",
"Research & Development",
"Scrum Master / Agile Coach",
"Software Development",
"Technician",
"Technology Operations",
"Test / Quality Assurance",
"Consulting",
"Consultant",
"Design",
"Other Design",
"Graphic / Visual / Brand Design",
"Education & Coaching",
"Teacher",
"Superintendent",
"Professor",
"Coach / Trainer",
"Finance",
"Financial Reporting",
"Financial Systems",
"Accounting",
"Finance & Banking",
"Financial Planning, Strategy & Analysis",
"Internal Audit & Control",
"Investor Relations",
"Mergers & Acquisitions",
"Real Estate Finance",
"Financial Risk",
"Sourcing / Procurement",
"Tax",
"Treasury",
"Human Resources",
"Compensation & Benefits",
"Culture, Diversity & Inclusion",
"Health & Safety",
"Other Human Resources",
"HR Business Partner",
"Learning & Development",
"Organizational Development",
"Recruiting & Talent Acquisition",
"Talent Management",
"Workforce Management",
"People Operations",
"Information Technology",
"Cloud Engineering",
"Data Center",
"Data Warehouse",
"Database Administration",
"eCommerce Development",
"Help Desk / Desktop Services",
"Information Security",
"IT Asset Management",
"IT Audit / IT Compliance",
"IT Recruitement",
"IT Procurement",
"IT Strategy",
"IT Training",
"Networking",
"Technical Lead",
"Quality Assurance",
"Retail / Store Systems",
"Servers",
"Disaster Recovery",
"Telecommunications",
"Legal",
"Compliance",
"Contracts",
"Corporate Secretary",
"eDiscovery",
"Ethics",
"Governance",
"Governmental Affairs & Regulatory Law",
"Intellectual Property & Patent",
"Labor & Employment",
"Lawyer / Attorney",
"Other Legal",
"Legal Counsel",
"Legal Operations",
"Litigation",
"Privacy",
"Marketing",
"Advertising",
"Brand Management",
"Content Marketing",
"Customer Experience",
"Customer Marketing",
"Growth & Demand Generation",
"Digital Marketing",
"eCommerce Marketing",
"Event & Field Marketing",
"Lead Generation",
"Marketing Operations",
"Product Marketing",
"Public Relations",
"SEO",
"Social Media Marketing",
"Technical Marketing",
"Medical & Health",
"Anesthesiology",
"Chiropractics",
"Clinical Systems",
"Dentistry",
"Dermatology",
"Doctors / Physicians",
"Epidemiology",
"Fire Responder",
"Infectious Disease",
"Medical Administration",
"Medical Education & Training",
"Clinical Research",
"Neurology",
"Nursing",
"Nutrition & Dietetics",
"Obstetrics / Gynecology",
"Oncology",
"Opthalmology",
"Optometry",
"Orthopedics",
"Radiology",
"Public Health",
"Psychology",
"Psychiatry",
"Physical Therapy",
"Pharmacy",
"Pediatrics",
"Pathology",
"Operations",
"Supply Chain",
"Store Operations",
"Safety",
"Real Estate",
"Quality Management",
"Physical Security",
"Office Operations",
"Logistics",
"Leasing",
"Facilities Management",
"Customer Service / Support",
"Corporate Strategy",
"Construction",
"Call Center",
"Sales",
"Other Sales",
"Sales Training",
"Sales Operations",
"Sales Engineering",
"Sales Enablement",
"Revenue Operations",
"Partnerships",
"Sales Development",
"Account Executive",
"Field / Outside Sales",
"Customer Success",
"Customer Retention & Development",
"Channel Sales",
"Account Management"
],
"type": "string"
},
"maxItems": 100,
"description": "Canonical values to exclude."
},
"include": {
"type": "array",
"items": {
"enum": [
"C-Suite",
"Chief Executive",
"Finance Executive",
"Founder",
"Human Resources Executive",
"Information Technology Executive",
"Legal Executive",
"Marketing Executive",
"Medical & Health Executive",
"Operations Executive",
"Sales Leader",
"Product",
"Product Development",
"Product Management",
"Other Product",
"Engineering & Technical",
"Artificial Intelligence / Machine Learning",
"Bioengineering",
"Biometrics",
"Business Intelligence",
"Chemical Engineering",
"Data Science & Analysis",
"DevOps",
"Digital Transformation",
"Emerging Technology / Innovation",
"Industrial Engineering",
"Mechanic",
"Mobile Development",
"Project Management",
"Research & Development",
"Scrum Master / Agile Coach",
"Software Development",
"Technician",
"Technology Operations",
"Test / Quality Assurance",
"Consulting",
"Consultant",
"Design",
"Other Design",
"Graphic / Visual / Brand Design",
"Education & Coaching",
"Teacher",
"Superintendent",
"Professor",
"Coach / Trainer",
"Finance",
"Financial Reporting",
"Financial Systems",
"Accounting",
"Finance & Banking",
"Financial Planning, Strategy & Analysis",
"Internal Audit & Control",
"Investor Relations",
"Mergers & Acquisitions",
"Real Estate Finance",
"Financial Risk",
"Sourcing / Procurement",
"Tax",
"Treasury",
"Human Resources",
"Compensation & Benefits",
"Culture, Diversity & Inclusion",
"Health & Safety",
"Other Human Resources",
"HR Business Partner",
"Learning & Development",
"Organizational Development",
"Recruiting & Talent Acquisition",
"Talent Management",
"Workforce Management",
"People Operations",
"Information Technology",
"Cloud Engineering",
"Data Center",
"Data Warehouse",
"Database Administration",
"eCommerce Development",
"Help Desk / Desktop Services",
"Information Security",
"IT Asset Management",
"IT Audit / IT Compliance",
"IT Recruitement",
"IT Procurement",
"IT Strategy",
"IT Training",
"Networking",
"Technical Lead",
"Quality Assurance",
"Retail / Store Systems",
"Servers",
"Disaster Recovery",
"Telecommunications",
"Legal",
"Compliance",
"Contracts",
"Corporate Secretary",
"eDiscovery",
"Ethics",
"Governance",
"Governmental Affairs & Regulatory Law",
"Intellectual Property & Patent",
"Labor & Employment",
"Lawyer / Attorney",
"Other Legal",
"Legal Counsel",
"Legal Operations",
"Litigation",
"Privacy",
"Marketing",
"Advertising",
"Brand Management",
"Content Marketing",
"Customer Experience",
"Customer Marketing",
"Growth & Demand Generation",
"Digital Marketing",
"eCommerce Marketing",
"Event & Field Marketing",
"Lead Generation",
"Marketing Operations",
"Product Marketing",
"Public Relations",
"SEO",
"Social Media Marketing",
"Technical Marketing",
"Medical & Health",
"Anesthesiology",
"Chiropractics",
"Clinical Systems",
"Dentistry",
"Dermatology",
"Doctors / Physicians",
"Epidemiology",
"Fire Responder",
"Infectious Disease",
"Medical Administration",
"Medical Education & Training",
"Clinical Research",
"Neurology",
"Nursing",
"Nutrition & Dietetics",
"Obstetrics / Gynecology",
"Oncology",
"Opthalmology",
"Optometry",
"Orthopedics",
"Radiology",
"Public Health",
"Psychology",
"Psychiatry",
"Physical Therapy",
"Pharmacy",
"Pediatrics",
"Pathology",
"Operations",
"Supply Chain",
"Store Operations",
"Safety",
"Real Estate",
"Quality Management",
"Physical Security",
"Office Operations",
"Logistics",
"Leasing",
"Facilities Management",
"Customer Service / Support",
"Corporate Strategy",
"Construction",
"Call Center",
"Sales",
"Other Sales",
"Sales Training",
"Sales Operations",
"Sales Engineering",
"Sales Enablement",
"Revenue Operations",
"Partnerships",
"Sales Development",
"Account Executive",
"Field / Outside Sales",
"Customer Success",
"Customer Retention & Development",
"Channel Sales",
"Account Management"
],
"type": "string"
},
"maxItems": 100,
"description": "Canonical values to include."
}
},
"description": "Canonical departments; include and exclude are mutually exclusive.",
"additionalProperties": false
},
"person_job_change": {
"type": "object",
"properties": {
"only_promotion": {
"type": "boolean",
"description": "Return promotions only. GROWTH+ only."
},
"timeframe_days": {
"enum": [
30,
60,
90,
180,
270,
365
],
"type": "integer",
"description": "Job-change lookback in days. GROWTH+ only."
},
"only_new_company": {
"type": "boolean",
"description": "Return moves to a new company only. GROWTH+ only."
}
},
"description": "Recent job-change criteria. GROWTH+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"company_attributes": {
"type": "object",
"properties": {
"b2b": {
"type": "boolean",
"description": "Filter by B2B status."
},
"demo": {
"type": "boolean",
"description": "Filter by demo availability."
},
"has_api": {
"type": "boolean",
"description": "Filter by API availability."
},
"has_sso": {
"type": "boolean",
"description": "Filter by SSO availability."
},
"pricing": {
"type": "boolean",
"description": "Filter by public-pricing presence."
},
"uses_ai": {
"type": "boolean",
"description": "Filter by use of AI."
},
"has_blog": {
"type": "boolean",
"description": "Filter by blog presence."
},
"has_ccpa": {
"type": "boolean",
"description": "Filter by CCPA compliance."
},
"has_gdpr": {
"type": "boolean",
"description": "Filter by GDPR compliance."
},
"has_soc2": {
"type": "boolean",
"description": "Filter by SOC 2 compliance."
},
"freetrial": {
"type": "boolean",
"description": "Filter by free-trial availability."
},
"has_hipaa": {
"type": "boolean",
"description": "Filter by HIPAA compliance."
},
"mobileapps": {
"type": "boolean",
"description": "Filter by mobile-app availability."
},
"has_academy": {
"type": "boolean",
"description": "Filter by academy presence."
},
"has_pci_dss": {
"type": "boolean",
"description": "Filter by PCI DSS compliance."
},
"has_podcast": {
"type": "boolean",
"description": "Filter by podcast presence."
},
"downloadable": {
"type": "boolean",
"description": "Filter by downloadable products."
},
"has_iso27001": {
"type": "boolean",
"description": "Filter by ISO 27001 compliance."
},
"onlinereviews": {
"type": "boolean",
"description": "Filter by online-review presence."
},
"data_residency": {
"type": "string",
"description": "Required data-residency location."
},
"has_esg_reports": {
"type": "boolean",
"description": "Filter by ESG-report availability."
},
"has_marketplace": {
"type": "boolean",
"description": "Filter by marketplace presence."
},
"has_open_source": {
"type": "boolean",
"description": "Filter by open-source offering."
},
"has_case_studies": {
"type": "boolean",
"description": "Filter by case-study presence."
},
"has_chat_support": {
"type": "boolean",
"description": "Filter by chat support."
},
"has_testimonials": {
"type": "boolean",
"description": "Filter by testimonial presence."
},
"other_compliance": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"description": "Other compliance standards, up to 50."
},
"has_email_support": {
"type": "boolean",
"description": "Filter by email support."
},
"has_phone_support": {
"type": "boolean",
"description": "Filter by phone support."
},
"is_venture_backed": {
"type": "boolean",
"description": "Filter by venture-backed status."
},
"has_knowledge_base": {
"type": "boolean",
"description": "Filter by knowledge-base presence."
},
"has_social_support": {
"type": "boolean",
"description": "Filter by social-media support."
},
"has_ticket_support": {
"type": "boolean",
"description": "Filter by ticket support."
},
"is_publicly_traded": {
"type": "boolean",
"description": "Filter by public-company status."
},
"has_community_forum": {
"type": "boolean",
"description": "Filter by community forum presence."
},
"has_chrome_extension": {
"type": "boolean",
"description": "Filter by Chrome extension availability."
},
"has_physical_offices": {
"type": "boolean",
"description": "Filter by physical-office presence."
},
"has_uptime_guarantee": {
"type": "boolean",
"description": "Filter by uptime guarantee."
},
"compliance_match_mode": {
"enum": [
"EXACT",
"CONTAINS"
],
"type": "string",
"description": "How other compliance values are matched."
},
"has_affiliate_program": {
"type": "boolean",
"description": "Filter by affiliate-program presence."
}
},
"description": "Explicit company product, support, compliance, and status attributes.",
"additionalProperties": false
},
"company_technology": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Values to exclude, up to 20."
},
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Values to include, up to 20."
}
},
"description": "Canonical technologies, up to 20 per list. STARTER+ only; FREE was verified to return PLAN_REQUIRED.",
"additionalProperties": false
},
"person_past_company": {
"type": "object",
"required": [
"company_oids"
],
"properties": {
"company_oids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"description": "Past Prospeo company IDs, 1-100. GROWTH+ only."
},
"combine_with_current": {
"enum": [
"OR",
"AND"
],
"type": "string",
"description": "How past and current companies combine. GROWTH+ only."
}
},
"description": "Past company criteria. GROWTH+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"company_integrations": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "Integrations to exclude, up to 10; requires include. GROWTH+ only."
},
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Integrations to include, up to 20. GROWTH+ only."
}
},
"description": "Integration criteria. GROWTH+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"company_key_customers": {
"type": "object",
"required": [
"include"
],
"properties": {
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"description": "Required values, 1-100."
}
},
"description": "Key customer names. GROWTH+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"person_past_job_title": {
"type": "object",
"required": [
"include"
],
"properties": {
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"description": "Past job titles, 1-50. GROWTH+ only."
},
"match_mode": {
"enum": [
"EXACT",
"CONTAINS"
],
"type": "string",
"description": "Past-title match mode. GROWTH+ only."
},
"titles_logic": {
"enum": [
"OR",
"AND"
],
"type": "string",
"description": "How past titles combine. GROWTH+ only."
},
"combine_with_current": {
"enum": [
"OR",
"AND"
],
"type": "string",
"description": "How past and current titles combine. GROWTH+ only."
}
},
"description": "Past title criteria. GROWTH+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"company_email_provider": {
"type": "array",
"items": {
"enum": [
"Microsoft",
"Google",
"Proofpoint",
"Mimecast",
"Other"
],
"type": "string"
},
"description": "Company email infrastructure providers."
},
"company_website_search": {
"type": "object",
"properties": {
"search_in": {
"type": "object",
"properties": {
"page_body": {
"type": "boolean",
"description": "Search page body text. PRO+ only."
},
"urls_only": {
"type": "boolean",
"description": "Search URLs only. PRO+ only."
},
"page_titles": {
"type": "boolean",
"description": "Search page titles. PRO+ only."
},
"headings_only": {
"type": "boolean",
"description": "Search headings only. PRO+ only."
},
"seo_description": {
"type": "boolean",
"description": "Search SEO descriptions. PRO+ only."
}
},
"description": "Website areas to search. PRO+ only.",
"additionalProperties": false
},
"match_mode": {
"enum": [
"any",
"all"
],
"type": "string",
"description": "Website keyword match mode. PRO+ only."
},
"page_scope": {
"type": "array",
"items": {
"enum": [
"homepage",
"product",
"blog",
"careers",
"about"
],
"type": "string"
},
"maxItems": 5,
"description": "Page scopes, up to 5. PRO+ only."
},
"has_sla_page": {
"type": "boolean",
"description": "Filter by SLA page. PRO+ only."
},
"url_contains": {
"type": "string",
"description": "Required URL substring. PRO+ only."
},
"has_status_page": {
"type": "boolean",
"description": "Filter by status page. PRO+ only."
},
"exclude_keywords": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "Website keywords to exclude, up to 10. PRO+ only."
},
"has_careers_page": {
"type": "boolean",
"description": "Filter by careers page. PRO+ only."
},
"include_keywords": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "Website keywords to include, up to 10. PRO+ only."
},
"has_investor_page": {
"type": "boolean",
"description": "Filter by investor page. PRO+ only."
},
"has_persona_pages": {
"type": "boolean",
"description": "Filter by persona pages. PRO+ only."
},
"has_security_page": {
"type": "boolean",
"description": "Filter by security page. PRO+ only."
},
"has_industry_pages": {
"type": "boolean",
"description": "Filter by industry pages. PRO+ only."
},
"has_solution_pages": {
"type": "boolean",
"description": "Filter by solution pages. PRO+ only."
},
"has_comparison_pages": {
"type": "boolean",
"description": "Filter by comparison pages. PRO+ only."
},
"has_developer_docs_page": {
"type": "boolean",
"description": "Filter by developer docs. PRO+ only."
}
},
"description": "Website-content criteria. PRO+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"max_person_per_company": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum people returned per company, 1-100."
},
"person_contact_details": {
"type": "object",
"properties": {
"email": {
"type": "array",
"items": {
"type": "string",
"const": "VERIFIED"
},
"description": "Require verified email availability; values are not revealed by search."
},
"mobile": {
"type": "array",
"items": {
"enum": [
"VERIFIED",
"UNAVAILABLE"
],
"type": "string"
},
"description": "Filter mobile availability; values are not revealed by search."
},
"operator": {
"enum": [
"OR",
"AND"
],
"type": "string",
"description": "How email and mobile conditions combine."
},
"hide_people_with_details_already_revealed": {
"type": "boolean",
"description": "Hide people whose contact details the team already revealed."
}
},
"description": "Contact availability only; search never reveals email or mobile values.",
"additionalProperties": false
},
"person_location_search": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"description": "Values to exclude, up to 100."
},
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"description": "Values to include, up to 100."
}
},
"description": "Canonical locations from SEARCH_SUGGESTIONS, up to 100 include and exclude values.",
"additionalProperties": false
},
"company_headcount_range": {
"type": "array",
"items": {
"enum": [
"1-10",
"11-20",
"21-50",
"51-100",
"101-200",
"201-500",
"501-1000",
"1001-2000",
"2001-5000",
"5001-10000",
"10000+"
],
"type": "string"
},
"description": "Canonical employee ranges; cannot combine with company_headcount_custom."
},
"company_location_search": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"description": "Values to exclude, up to 100."
},
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"description": "Values to include, up to 100."
}
},
"description": "Canonical company locations, up to 100 include and exclude values.",
"additionalProperties": false
},
"company_website_traffic": {
"type": "object",
"properties": {
"visit_change": {
"type": "object",
"properties": {
"period": {
"enum": [
"monthly",
"quarterly",
"yearly"
],
"type": "string",
"description": "Traffic-change period. PRO+ only."
},
"max_change": {
"type": "number",
"maximum": 10000,
"minimum": -100,
"description": "Maximum traffic change. PRO+ only."
},
"min_change": {
"type": "number",
"maximum": 10000,
"minimum": -100,
"description": "Minimum traffic change. PRO+ only."
}
},
"description": "Traffic-change range. PRO+ only.",
"additionalProperties": false
},
"top_countries": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"description": "Top visitor countries, 1-5. PRO+ only."
},
"max_country_pct": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Maximum country traffic percentage. PRO+ only."
},
"min_country_pct": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Minimum country traffic percentage. PRO+ only."
},
"max_monthly_visits": {
"type": "integer",
"maximum": 100000000,
"minimum": 0,
"description": "Maximum monthly visits. PRO+ only."
},
"min_monthly_visits": {
"type": "integer",
"maximum": 100000000,
"minimum": 0,
"description": "Minimum monthly visits. PRO+ only."
}
},
"description": "Website traffic criteria. PRO+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"company_google_discovery": {
"type": "object",
"required": [
"seo_keywords"
],
"properties": {
"seo_keywords": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"description": "SEO keywords, 1-100. PRO+ only."
}
},
"description": "Google SEO discovery. PRO+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"company_headcount_custom": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"maximum": 999999,
"minimum": 1,
"description": "Inclusive maximum employee count."
},
"min": {
"type": "integer",
"maximum": 999998,
"minimum": 1,
"description": "Inclusive minimum employee count."
}
},
"description": "Custom employee-count range; cannot combine with company_headcount_range.",
"additionalProperties": false
},
"company_headcount_growth": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"maximum": 10000,
"minimum": -100,
"description": "Maximum headcount growth percentage."
},
"min": {
"type": "integer",
"maximum": 10000,
"minimum": -100,
"description": "Minimum headcount growth percentage."
},
"departments": {
"type": "array",
"items": {
"enum": [
"Administrative",
"Consulting",
"Customer service",
"Design / UI / UX",
"Education",
"Finance",
"General management",
"HR",
"Legal",
"Marketing",
"Medical",
"Operations",
"Product",
"Project management",
"Real estate",
"Research",
"Sales",
"Technical",
"Trades"
],
"type": "string"
},
"maxItems": 10,
"description": "Canonical departments, up to 10."
},
"timeframe_month": {
"enum": [
3,
6,
12,
24
],
"type": "integer",
"description": "Growth measurement window in months."
}
},
"description": "Headcount-growth criteria.",
"additionalProperties": false
},
"person_name_or_job_title": {
"type": "string",
"minLength": 1,
"description": "Free-text quick search across person name and current job title."
},
"company_products_services": {
"type": "object",
"properties": {
"products_exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "Products to exclude, up to 10; requires products_include."
},
"products_include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Products to include, up to 20."
},
"products_match_all": {
"type": "boolean",
"description": "Require all included products."
},
"service_tags_exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "Service tags to exclude, up to 10; requires service_tags_include."
},
"service_tags_include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Service tags to include, up to 20."
},
"service_tags_match_all": {
"type": "boolean",
"description": "Require all included service tags."
}
},
"description": "Products and services criteria.",
"additionalProperties": false
},
"person_year_of_experience": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"maximum": 60,
"minimum": 1,
"description": "Maximum years of experience."
},
"min": {
"type": "integer",
"maximum": 60,
"minimum": 0,
"description": "Minimum years of experience."
}
},
"description": "Total years-of-experience range.",
"additionalProperties": false
},
"company_operating_languages": {
"type": "object",
"required": [
"include"
],
"properties": {
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"description": "Operating languages to include, 1-10."
}
},
"description": "Filter companies by languages they operate in; use Search Filter Suggestions to resolve canonical language values.",
"additionalProperties": false
},
"person_time_in_current_role": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"maximum": 600,
"minimum": 0,
"description": "Maximum number of months."
},
"min": {
"type": "integer",
"maximum": 600,
"minimum": 0,
"description": "Minimum number of months."
}
},
"description": "Months in current role.",
"additionalProperties": false
},
"company_job_posting_quantity": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"maximum": 5000,
"minimum": 0,
"description": "Maximum active postings. STARTER+ only."
},
"min": {
"type": "integer",
"maximum": 5000,
"minimum": 0,
"description": "Minimum active postings. STARTER+ only."
}
},
"description": "Active job-posting count. STARTER+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"person_awards_certifications": {
"type": "object",
"properties": {
"awards": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Award names, up to 20. GROWTH+ only."
},
"award_issuers": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Award issuers, up to 20. GROWTH+ only."
},
"award_year_max": {
"type": "integer",
"minimum": 1900,
"description": "Latest award year; requires an award or issuer. GROWTH+ only."
},
"award_year_min": {
"type": "integer",
"minimum": 1900,
"description": "Earliest award year; requires an award or issuer. GROWTH+ only."
},
"certifications": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Certification names, up to 20. GROWTH+ only."
},
"certification_issuers": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Certification issuers, up to 20. GROWTH+ only."
},
"certification_year_max": {
"type": "integer",
"minimum": 1900,
"description": "Latest certification year; requires a certification or issuer. GROWTH+ only."
},
"certification_year_min": {
"type": "integer",
"minimum": 1900,
"description": "Earliest certification year; requires a certification or issuer. GROWTH+ only."
}
},
"description": "Awards and certifications. GROWTH+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"company_headcount_by_location": {
"type": "object",
"required": [
"entries"
],
"properties": {
"entries": {
"type": "array",
"items": {
"type": "object",
"required": [
"country"
],
"properties": {
"country": {
"type": "string",
"minLength": 1,
"description": "Country name."
},
"max_headcount": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Maximum country headcount."
},
"min_headcount": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Minimum country headcount."
}
}
},
"maxItems": 10,
"minItems": 1,
"description": "Country headcount ranges, 1-10. GROWTH+ only."
}
},
"description": "Country headcount ranges. GROWTH+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"company_job_posting_hiring_for": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"description": "Job titles to exclude. STARTER+ only."
},
"include": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"description": "Job titles to include. STARTER+ only."
},
"match_type": {
"enum": [
"contains",
"exact"
],
"type": "string",
"description": "Job-title match type. STARTER+ only."
},
"boolean_search": {
"type": "string",
"description": "Boolean job-title query. STARTER+ only; cannot combine with include or exclude."
}
},
"description": "Hiring-title criteria. STARTER+ only; lower plans return PLAN_REQUIRED.",
"additionalProperties": false
},
"person_time_in_current_company": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"maximum": 600,
"minimum": 0,
"description": "Maximum number of months."
},
"min": {
"type": "integer",
"maximum": 600,
"minimum": 0,
"description": "Minimum number of months."
}
},
"description": "Months at current company.",
"additionalProperties": false
},
"company_headcount_by_department": {
"type": "array",
"items": {
"type": "object",
"required": [
"department"
],
"properties": {
"max": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Maximum department headcount."
},
"min": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Minimum department headcount."
},
"department": {
"enum": [
"C-Suite",
"Chief Executive",
"Finance Executive",
"Founder",
"Human Resources Executive",
"Information Technology Executive",
"Legal Executive",
"Marketing Executive",
"Medical & Health Executive",
"Operations Executive",
"Sales Leader",
"Product",
"Product Development",
"Product Management",
"Other Product",
"Engineering & Technical",
"Artificial Intelligence / Machine Learning",
"Bioengineering",
"Biometrics",
"Business Intelligence",
"Chemical Engineering",
"Data Science & Analysis",
"DevOps",
"Digital Transformation",
"Emerging Technology / Innovation",
"Industrial Engineering",
"Mechanic",
"Mobile Development",
"Project Management",
"Research & Development",
"Scrum Master / Agile Coach",
"Software Development",
"Technician",
"Technology Operations",
"Test / Quality Assurance",
"Consulting",
"Consultant",
"Design",
"Other Design",
"Graphic / Visual / Brand Design",
"Education & Coaching",
"Teacher",
"Superintendent",
"Professor",
"Coach / Trainer",
"Finance",
"Financial Reporting",
"Financial Systems",
"Accounting",
"Finance & Banking",
"Financial Planning, Strategy & Analysis",
"Internal Audit & Control",
"Investor Relations",
"Mergers & Acquisitions",
"Real Estate Finance",
"Financial Risk",
"Sourcing / Procurement",
"Tax",
"Treasury",
"Human Resources",
"Compensation & Benefits",
"Culture, Diversity & Inclusion",
"Health & Safety",
"Other Human Resources",
"HR Business Partner",
"Learning & Development",
"Organizational Development",
"Recruiting & Talent Acquisition",
"Talent Management",
"Workforce Management",
"People Operations",
"Information Technology",
"Cloud Engineering",
"Data Center",
"Data Warehouse",
"Database Administration",
"eCommerce Development",
"Help Desk / Desktop Services",
"Information Security",
"IT Asset Management",
"IT Audit / IT Compliance",
"IT Recruitement",
"IT Procurement",
"IT Strategy",
"IT Training",
"Networking",
"Technical Lead",
"Quality Assurance",
"Retail / Store Systems",
"Servers",
"Disaster Recovery",
"Telecommunications",
"Legal",
"Compliance",
"Contracts",
"Corporate Secretary",
"eDiscovery",
"Ethics",
"Governance",
"Governmental Affairs & Regulatory Law",
"Intellectual Property & Patent",
"Labor & Employment",
"Lawyer / Attorney",
"Other Legal",
"Legal Counsel",
"Legal Operations",
"Litigation",
"Privacy",
"Marketing",
"Advertising",
"Brand Management",
"Content Marketing",
"Customer Experience",
"Customer Marketing",
"Growth & Demand Generation",
"Digital Marketing",
"eCommerce Marketing",
"Event & Field Marketing",
"Lead Generation",
"Marketing Operations",
"Product Marketing",
"Public Relations",
"SEO",
"Social Media Marketing",
"Technical Marketing",
"Medical & Health",
"Anesthesiology",
"Chiropractics",
"Clinical Systems",
"Dentistry",
"Dermatology",
"Doctors / Physicians",
"Epidemiology",
"Fire Responder",
"Infectious Disease",
"Medical Administration",
"Medical Education & Training",
"Clinical Research",
"Neurology",
"Nursing",
"Nutrition & Dietetics",
"Obstetrics / Gynecology",
"Oncology",
"Opthalmology",
"Optometry",
"Orthopedics",
"Radiology",
"Public Health",
"Psychology",
"Psychiatry",
"Physical Therapy",
"Pharmacy",
"Pediatrics",
"Pathology",
"Operations",
"Supply Chain",
"Store Operations",
"Safety",
"Real Estate",
"Quality Management",
"Physical Security",
"Office Operations",
"Logistics",
"Leasing",
"Facilities Management",
"Customer Service / Support",
"Corporate Strategy",
"Construction",
"Call Center",
"Sales",
"Other Sales",
"Sales Training",
"Sales Operations",
"Sales Engineering",
"Sales Enablement",
"Revenue Operations",
"Partnerships",
"Sales Development",
"Account Executive",
"Field / Outside Sales",
"Customer Success",
"Customer Retention & Development",
"Channel Sales",
"Account Management"
],
"type": "string",
"description": "Canonical department name."
}
}
},
"maxItems": 10,
"description": "Department-specific headcount ranges, up to 10."
}
},
"description": "Typed person and company filters. Required on the first page and restored automatically from next_cursor on continuation pages. At least one positive filter is required. Dashboard-only persona_ids, company_list_oids, and temp_matching_oids are not supported.",
"additionalProperties": false
},
"next_cursor": {
"type": "string",
"description": "Opaque cursor from a prior response. Omit for page one; when provided, omit filters because the cursor restores them and advances one page."
}
}
}
}
}
},
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "response_units",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.0243,
"estimate_source": "profile_seed",
"evidence_source": "response_body",
"maximum_units": 10000000,
"unit": "provider_credit",
"unit_rate_usd": 1e-06
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
Usage-based billing; Default request estimate: $0.0243 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.- Default request reference estimate (USD): 0.0243
- Declared unit rate (USD): 1e-06
- Billing unit: provider_credit
- Cost contract: response_units
- Published reference multiplier: 1.0
- Declared maximum count/units: 10000000
- Settlement evidence source: response_body
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Typed person and company filters. Required on the first page and restored automatically from next_cursor on continuation pages. At least one positive filter is required. Dashboard-only persona_ids, company_list_oids, and temp_matching_oids are not supported.
Show child attributes
Show child attributes
Example:
{ "company": { "websites": { "include": ["openai.com"] } } }
Opaque cursor from a prior response. Omit for page one; when provided, omit filters because the cursor restores them and advances one page.