Provided by Prospeo
Search People by Job Title, Seniority, Department, Employer or Technology (Prospeo)
$0.02695 per callanswers within 30s
Find people in Prospeo's index by criteria you set in Prospeo's own nested include and exclude filters: job title, seniority, department, employer website, employer size, industry, a technology the employer runs, or location. Each row carries the person and their employer and nothing beyond that, which makes it a shortlist rather than a reveal — pair it with the Prospeo work address Endpoint to reach anyone on the list. Twenty-five people per page, one page per call.
How to run it
Step 1Set up
Once: paste this into your agent's chat. The Skill installs the CLI and logs in by itself. For an agent that cannot use a shell, connect it over MCP instead.
Set up
set up https://glasser.ai/SKILL.md
Show me how to use the Prospeo endpoint /search-person on Glasser.bash
glasser run -p prospeo -e '/search-person' -i '{"page":1,"filters":{"company":{"websites":{"include":["stripe.com"]}},"person_job_title":{"include":["account executive"],"match_mode":"CONTAINS"},"person_seniority":{"include":["Senior"]}}}' --endpoint-version 5Uses endpoint version 5. Inspect the current price before running. Install and log in first on Get Started.
Once per Run:
bash
IDEMPOTENCY_KEY=$(uuidgen)Run it, and copy this same block to send it again:
bash
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"prospeo","endpoint":"/search-person","input":{"page":1,"filters":{"company":{"websites":{"include":["stripe.com"]}},"person_job_title":{"include":["account executive"],"match_mode":"CONTAINS"},"person_seniority":{"include":["Senior"]}}},"endpoint_version":5}'Reuse the same Idempotency-Key to send it again: the second send is a read of the first Run. A new key is a new Run and a new Charge. Uses endpoint version 5; inspect the current price before running.
Step 2Try a specific example task
When you need to shortlist jobs, you might compare the available roles with your skills to find opportunities worth reviewing more closely.
Copy this prompt into your agent to review job matches for your skills.
Prompt
Use prospeo:/search-person on Glasser.
Find roles matching my skills in the returned job data and explain each match.Endpoint structure
json
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"filters"
],
"properties": {
"page": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"filters": {
"type": "object",
"properties": {
"company": {
"type": "object",
"properties": {
"names": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500
},
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500
}
},
"description": "Company names, e.g. \"Walmart\". A name can match several unrelated companies; prefer websites when you know them.",
"additionalProperties": false
},
"websites": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?:https?:\\/\\/)?(?!www\\.)(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)+[a-z]{2,63}\\/?$",
"maxLength": 253
},
"maxItems": 500
},
"include": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?:https?:\\/\\/)?(?!www\\.)(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)+[a-z]{2,63}\\/?$",
"maxLength": 253
},
"maxItems": 500
}
},
"description": "Company root domains, e.g. \"stripe.com\", \"bbc.co.uk\". Root domains only: \"www.\" is refused here, and Prospeo rejects other subdomains (\"video.example.com\"). At most 500 websites and names together.",
"additionalProperties": false
},
"company_oids": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 10
},
"maxItems": 5000
},
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 10
},
"maxItems": 5000
}
},
"description": "Prospeo company IDs (the company_id field of any company Prospeo returns). Matches people whose current employer is one of these companies.",
"additionalProperties": false
}
},
"description": "Restrict to specific companies. Only websites, names and company_oids go here; industry, headcount and location are separate top-level filters.",
"additionalProperties": false
},
"company_icp": {
"type": "object",
"description": "Ideal customer profile signals, e.g. { titles_include: [\"CTO\"], company_sizes: [\"smb\", \"midmarket\"], geographic_markets: [\"US\"] }. Field list: https://prospeo.io/api-docs/filters-documentation#company_icp."
},
"person_name": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 500
},
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 500
},
"person_oids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 10
},
"maxItems": 50
}
},
"description": "Strict name match, e.g. { include: [\"Jane Doe\"] }, or Prospeo person IDs in person_oids. Do not send together with person_search.",
"additionalProperties": false
},
"company_news": {
"type": "object",
"properties": {
"keywords": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 20
},
{
"type": "null"
}
]
},
"categories": {
"anyOf": [
{
"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
},
{
"type": "null"
}
]
},
"timeframe_days": {
"enum": [
60,
90,
180,
365
],
"type": "number"
}
},
"description": "Recent company news, e.g. { categories: [\"Funding & Investment\"], timeframe_days: 180 }.",
"additionalProperties": false
},
"company_sics": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "integer",
"maximum": 1000000,
"minimum": 1
},
"maxItems": 100
},
"include": {
"type": "array",
"items": {
"type": "integer",
"maximum": 1000000,
"minimum": 1
},
"maxItems": 100
}
},
"description": "SIC codes as integers, e.g. 7372. Look codes up at https://prospeo.io/api-docs/search-suggestions.",
"additionalProperties": false
},
"company_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Company type: a status string (\"Private\", \"Public\", \"Non Profit\", \"Other\") or an object such as { status: \"Private\", subtypes: { include: [\"SaaS\"] }, business_model: \"b2b\" }. Field list: https://prospeo.io/api-docs/filters-documentation#company_type."
},
"company_naics": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "integer",
"maximum": 1000000,
"minimum": 1
},
"maxItems": 100
},
"include": {
"type": "array",
"items": {
"type": "integer",
"maximum": 1000000,
"minimum": 1
},
"maxItems": 100
}
},
"description": "NAICS codes as integers, e.g. 541511. Look codes up with the Prospeo filter-values Endpoint or at https://prospeo.io/api-docs/search-suggestions.",
"additionalProperties": false
},
"person_search": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 500
},
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 500
},
"match_mode": {
"enum": [
"SMART",
"STRICT"
],
"type": "string"
}
},
"description": "People by name, company name or company domain, e.g. { include: [\"John Smith\"], match_mode: \"SMART\" }. Do not send together with person_name.",
"additionalProperties": false
},
"company_awards": {
"type": "object",
"required": [
"include"
],
"properties": {
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 50
},
"match_mode": {
"enum": [
"EXACT",
"CONTAINS"
],
"type": "string"
}
},
"description": "Awards the company received, e.g. { include: [\"Inc 5000\"], match_mode: \"EXACT\" }.",
"additionalProperties": false
},
"company_intent": {
"type": "object",
"required": [
"topic_ids"
],
"properties": {
"topic_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"maxItems": 30
},
"early_research": {
"type": "boolean"
},
"active_research": {
"type": "boolean"
},
"in_depth_research": {
"type": "boolean"
}
},
"description": "Buying-intent topics by name as configured in the Prospeo dashboard, e.g. { topic_ids: [\"CRM Software\"], active_research: true }.",
"additionalProperties": false
},
"company_founded": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"maximum": 2100,
"minimum": 1900
},
"min": {
"type": "integer",
"maximum": 2100,
"minimum": 1900
},
"include_unknown_founded": {
"type": "boolean"
}
},
"description": "Founding year range, e.g. { min: 2010, max: 2020 }.",
"additionalProperties": false
},
"company_funding": {
"type": "object",
"properties": {
"stage": {
"type": "array",
"items": {
"enum": [
"Series unknown",
"Pre seed",
"Seed",
"Series A",
"Series B",
"Series C",
"Series D",
"Series E-J",
"Grant",
"Angel",
"Private equity",
"Debt financing",
"Non equity assistance",
"Post IPO equity",
"Undisclosed",
"Post IPO debt",
"Product crowdfunding",
"Equity crowdfunding",
"Corporate round",
"Convertible note",
"Secondary market",
"Initial coin offering",
"Post IPO secondary"
],
"type": "string"
},
"maxItems": 500
},
"investors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 10
},
"funding_date": {
"enum": [
30,
60,
90,
180,
270,
365
],
"type": "number",
"description": "Days since the last funding round."
},
"last_funding": {
"type": "object",
"properties": {
"max": {
"enum": [
"<100K",
"100K",
"500K",
"1M",
"5M",
"10M",
"25M",
"50M",
"100M",
"250M",
"500M",
"1B",
"5B",
"10B+"
],
"type": "string"
},
"min": {
"enum": [
"<100K",
"100K",
"500K",
"1M",
"5M",
"10M",
"25M",
"50M",
"100M",
"250M",
"500M",
"1B",
"5B",
"10B+"
],
"type": "string"
}
},
"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"
},
"min": {
"enum": [
"<100K",
"100K",
"500K",
"1M",
"5M",
"10M",
"25M",
"50M",
"100M",
"250M",
"500M",
"1B",
"5B",
"10B+"
],
"type": "string"
}
},
"additionalProperties": false
},
"accelerator_name": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"was_in_accelerator": {
"type": "boolean"
}
},
"description": "Funding filters, e.g. { stage: [\"Series A\", \"Series B\"], funding_date: 365 }. Amounts use Prospeo revenue bands such as \"1M\", \"100M\", \"10B+\".",
"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"
},
"min": {
"enum": [
"<100K",
"100K",
"500K",
"1M",
"5M",
"10M",
"25M",
"50M",
"100M",
"250M",
"500M",
"1B",
"5B",
"10B+"
],
"type": "string"
},
"include_unknown_revenue": {
"type": "boolean"
}
},
"description": "Revenue band, e.g. { min: \"10M\", max: \"500M\" }. Values: <100K, 100K, 500K, 1M, 5M, 10M, 25M, 50M, 100M, 250M, 500M, 1B, 5B, 10B+.",
"additionalProperties": false
},
"company_industry": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500
},
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500
}
},
"description": "Industry names exactly as listed at https://prospeo.io/api-docs/enum/industries (about 256 values), e.g. \"Software Development\", \"IT Services and IT Consulting\". Older LinkedIn names such as \"Computer Software\" are rejected.",
"additionalProperties": false
},
"company_keywords": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 3
},
"maxItems": 20
},
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 3
},
"maxItems": 20
},
"sources": {
"type": "array",
"items": {
"enum": [
"specialties",
"social_media_description",
"seo_description",
"ai_description",
"products_services",
"website_pages"
],
"type": "string"
}
},
"include_all": {
"type": "boolean"
},
"search_everywhere": {
"type": "boolean"
}
},
"description": "Keywords across company data sources, e.g. { include: [\"saas\", \"b2b\"], include_all: false }. Exclude needs at least one include.",
"additionalProperties": false
},
"person_education": {
"type": "object",
"properties": {
"degrees": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 1
}
},
"schools": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 20
},
"graduated_max": {
"type": "integer",
"maximum": 2100,
"minimum": 1900
},
"graduated_min": {
"type": "integer",
"maximum": 2100,
"minimum": 1900
},
"fields_of_study": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 20
}
},
"description": "Education, e.g. { schools: [\"Stanford University\"], degrees: [\"mba\"], graduated_min: 2010 }. Degrees: high school, associate, bachelors, masters, mba, phd, professional, diploma, vocational, other.",
"additionalProperties": false
},
"person_job_title": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"maxItems": 100
},
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"maxItems": 100
},
"match_mode": {
"enum": [
"CONTAINS",
"EXACT",
"SIMILAR"
],
"type": "string",
"description": "CONTAINS matches titles containing the term (recommended), EXACT the whole title, SIMILAR related titles."
},
"boolean_search": {
"type": "string",
"maxLength": 5000,
"minLength": 2,
"description": "A boolean title expression such as \"(CEO OR CTO) AND !Intern\". Cannot be combined with include or exclude."
},
"smart_intensity": {
"enum": [
"LOOSE",
"NORMAL",
"STRICT"
],
"type": "string"
}
},
"description": "Current job title, e.g. { include: [\"account executive\"], match_mode: \"CONTAINS\" }. Valid title strings come from the Prospeo filter-values Endpoint.",
"additionalProperties": false
},
"person_seniority": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"enum": [
"Founder/Owner",
"C-Suite",
"Partner",
"Vice President",
"Head",
"Director",
"Manager",
"Senior",
"Entry",
"Intern"
],
"type": "string"
},
"maxItems": 10
},
"include": {
"type": "array",
"items": {
"enum": [
"Founder/Owner",
"C-Suite",
"Partner",
"Vice President",
"Head",
"Director",
"Manager",
"Senior",
"Entry",
"Intern"
],
"type": "string"
},
"maxItems": 10
}
},
"description": "Seniority levels, e.g. { include: [\"Vice President\", \"Director\"] } (\"VP\" is rejected). Use include or exclude, not both.",
"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
},
"timeframe_days": {
"enum": [
60,
90,
180,
365
],
"type": "number"
}
},
"description": "Executive changes, e.g. { event_types: [\"CEO Departed\", \"Any VP Appointed\"], timeframe_days: 180 }.",
"additionalProperties": false
},
"company_lookalike": {
"type": "object",
"description": "Similar companies. Use exactly one seed: { company_oids: [...] }, { icp_text: \"...\" }, { domain: \"hubspot.com\" } or (person search only) { person_oids: [...] }; optional match_all, same_language, minimum_tier (\"T1\", \"T2\", \"T3\")."
},
"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",
"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",
"Consulting",
"Consultant",
"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",
"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"
],
"type": "string"
},
"maxItems": 500
},
"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",
"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",
"Consulting",
"Consultant",
"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",
"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"
],
"type": "string"
},
"maxItems": 500
}
},
"description": "Departments from https://prospeo.io/api-docs/enum/departments, e.g. { include: [\"Sales\", \"Marketing\"] }. A main department includes its sub-departments. Use include or exclude, not both.",
"additionalProperties": false
},
"person_job_change": {
"type": "object",
"properties": {
"only_promotion": {
"type": "boolean"
},
"timeframe_days": {
"enum": [
30,
60,
90,
180,
270,
365
],
"type": "number"
},
"only_new_company": {
"type": "boolean"
}
},
"description": "Recent job change, e.g. { timeframe_days: 90, only_new_company: true }. only_promotion and only_new_company cannot both be true.",
"additionalProperties": false
},
"company_attributes": {
"type": "object",
"description": "Company attribute flags such as { b2b: true, has_api: true, has_soc2: true } (true requires, false excludes, null ignores). Field list: https://prospeo.io/api-docs/filters-documentation#company_attributes."
},
"company_technology": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 20
},
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 20
}
},
"description": "Technologies the company uses, exactly as listed at https://prospeo.io/api-docs/enum/technologies, e.g. \"Salesforce\", \"HubSpot\". At most 20 per list.",
"additionalProperties": false
},
"person_past_company": {
"type": "object",
"required": [
"company_oids"
],
"properties": {
"company_oids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 10
},
"maxItems": 100
},
"combine_with_current": {
"enum": [
"OR",
"AND"
],
"type": "string"
}
},
"description": "Companies worked at before the current employer, by Prospeo company ID, e.g. { company_oids: [\"507f1f77bcf86cd799439011\"] }.",
"additionalProperties": false
},
"company_integrations": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 10
},
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 20
}
},
"description": "Integrations named on the company website, e.g. { include: [\"Salesforce\", \"Slack\"] }.",
"additionalProperties": false
},
"company_key_customers": {
"type": "object",
"required": [
"include"
],
"properties": {
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100
}
},
"description": "Known customers of the company, e.g. { include: [\"Google\", \"Microsoft\"] }.",
"additionalProperties": false
},
"person_past_job_title": {
"type": "object",
"required": [
"include"
],
"properties": {
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 50
},
"match_mode": {
"enum": [
"EXACT",
"CONTAINS"
],
"type": "string"
},
"titles_logic": {
"enum": [
"OR",
"AND"
],
"type": "string"
},
"combine_with_current": {
"enum": [
"OR",
"AND"
],
"type": "string"
}
},
"description": "Titles held before the current role, e.g. { include: [\"Account Executive\"], match_mode: \"CONTAINS\" }.",
"additionalProperties": false
},
"company_email_provider": {
"type": "array",
"items": {
"enum": [
"Microsoft",
"Google",
"Proofpoint",
"Mimecast",
"Other"
],
"type": "string"
},
"maxItems": 5,
"description": "Company email providers as a plain array, e.g. [\"Google\"]."
},
"company_website_search": {
"type": "object",
"description": "Full-text search over crawled company websites, e.g. { include_keywords: [\"SOC 2\"], match_mode: \"any\", page_scope: [\"product\"] }. Field list: https://prospeo.io/api-docs/filters-documentation#company_website_search."
},
"max_person_per_company": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "At most this many people per company (1-100)."
},
"person_contact_details": {
"type": "object",
"properties": {
"email": {
"type": "array",
"items": {
"anyOf": [
{
"enum": [
"VERIFIED"
],
"type": "string"
}
]
}
},
"mobile": {
"type": "array",
"items": {
"enum": [
"VERIFIED",
"UNAVAILABLE"
],
"type": "string"
}
},
"operator": {
"enum": [
"OR",
"AND"
],
"type": "string"
},
"hide_people_with_details_already_revealed": {
"type": "boolean"
}
},
"description": "Availability of a verified email or mobile, e.g. { email: [\"VERIFIED\"], operator: \"OR\" }.",
"additionalProperties": false
},
"person_location_search": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 100
},
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 100
}
},
"description": "Where the person is, e.g. \"United States\", \"New York, United States\". Copy values exactly from the Prospeo filter-values Endpoint (/search-suggestions); free text such as \"nyc\" is rejected.",
"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"
},
"maxItems": 11,
"description": "Employee-count bands as a plain array (no include/exclude), e.g. [\"51-100\", \"101-200\"]. Cannot be combined with company_headcount_custom. For a band the list does not have, use company_headcount_custom."
},
"company_location_search": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 100
},
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 100
}
},
"description": "Company headquarters locations, e.g. \"United States\", \"San Francisco, California\". Copy values exactly from the Prospeo filter-values Endpoint (/search-suggestions); free text such as \"nyc\" is rejected.",
"additionalProperties": false
},
"company_website_traffic": {
"type": "object",
"description": "Website traffic, e.g. { min_monthly_visits: 10000, visit_change: { period: \"quarterly\", min_change: 10 }, top_countries: [\"United States\"] }. Field list: https://prospeo.io/api-docs/filters-documentation#company_website_traffic."
},
"company_google_discovery": {
"type": "object",
"required": [
"seo_keywords"
],
"properties": {
"seo_keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100
}
},
"description": "SEO keywords the company ranks for, e.g. { seo_keywords: [\"email finder\"] }.",
"additionalProperties": false
},
"company_headcount_custom": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"maximum": 999999,
"minimum": 1
},
"min": {
"type": "integer",
"maximum": 999999,
"minimum": 1
}
},
"description": "A custom employee-count range, e.g. { min: 1000, max: 5000 }. Cannot be combined with company_headcount_range.",
"additionalProperties": false
},
"company_headcount_growth": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"maximum": 10000,
"minimum": -100
},
"min": {
"type": "integer",
"maximum": 10000,
"minimum": -100
},
"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",
"Other"
],
"type": "string"
},
"maxItems": 10
},
"timeframe_month": {
"enum": [
3,
6,
12,
24
],
"type": "number"
}
},
"description": "Headcount growth in percent over 3, 6, 12 or 24 months, e.g. { timeframe_month: 12, min: 10, max: 100, departments: [\"Sales\"] }.",
"additionalProperties": false
},
"person_name_or_job_title": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Quick free-text match over name and job title, e.g. \"Kevin\"."
},
"company_products_services": {
"type": "object",
"properties": {
"products_exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 10
},
"products_include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 20
},
"products_match_all": {
"type": "boolean"
},
"service_tags_exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 10
},
"service_tags_include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 20
},
"service_tags_match_all": {
"type": "boolean"
}
},
"description": "Product and service tags, e.g. { products_include: [\"CRM\"], service_tags_include: [\"consulting\"] }.",
"additionalProperties": false
},
"person_year_of_experience": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"maximum": 60,
"minimum": 0
},
"min": {
"type": "integer",
"maximum": 60,
"minimum": 0
}
},
"description": "Total years of professional experience, e.g. { min: 5, max: 15 }.",
"additionalProperties": false
},
"company_operating_languages": {
"type": "object",
"required": [
"include"
],
"properties": {
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 1
},
"maxItems": 10
}
},
"description": "Languages the company operates in, e.g. { include: [\"English\", \"French\"] }.",
"additionalProperties": false
},
"person_time_in_current_role": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"maximum": 600,
"minimum": 0
},
"min": {
"type": "integer",
"maximum": 600,
"minimum": 0
}
},
"description": "Months in the current role, e.g. { min: 6, max: 24 }.",
"additionalProperties": false
},
"company_job_posting_quantity": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"maximum": 5000,
"minimum": 0
},
"min": {
"type": "integer",
"maximum": 5000,
"minimum": 0
}
},
"description": "Number of active job postings, e.g. { min: 10, max: 100 }.",
"additionalProperties": false
},
"person_awards_certifications": {
"type": "object",
"properties": {
"awards": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 20
},
"award_issuers": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 20
},
"award_year_max": {
"type": "integer",
"maximum": 2100,
"minimum": 1900
},
"award_year_min": {
"type": "integer",
"maximum": 2100,
"minimum": 1900
},
"certifications": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 20
},
"certification_issuers": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 20
},
"certification_year_max": {
"type": "integer",
"maximum": 2100,
"minimum": 1900
},
"certification_year_min": {
"type": "integer",
"maximum": 2100,
"minimum": 1900
}
},
"description": "Certifications and awards, e.g. { certification_issuers: [\"Amazon Web Services\"], certification_year_min: 2020 }.",
"additionalProperties": false
},
"company_headcount_by_location": {
"type": "object",
"required": [
"entries"
],
"properties": {
"entries": {
"type": "array",
"items": {
"type": "object",
"required": [
"country"
],
"properties": {
"country": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"max_headcount": {
"anyOf": [
{
"type": "integer",
"maximum": 1000000,
"minimum": 0
},
{
"type": "null"
}
]
},
"min_headcount": {
"anyOf": [
{
"type": "integer",
"maximum": 1000000,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"description": "One country headcount condition.",
"additionalProperties": false
},
"maxItems": 10
}
},
"description": "Employees in specific countries, e.g. { entries: [{ country: \"United States\", min_headcount: 50 }] }.",
"additionalProperties": false
},
"company_job_posting_hiring_for": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500
},
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500
},
"match_type": {
"enum": [
"contains",
"exact"
],
"type": "string"
},
"boolean_search": {
"type": "string",
"maxLength": 5000,
"minLength": 2
}
},
"description": "Job titles the company is hiring for, e.g. { include: [\"Software Engineer\"], match_type: \"contains\" }, or { boolean_search: \"(engineer OR developer) AND !intern\" }.",
"additionalProperties": false
},
"person_time_in_current_company": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"maximum": 600,
"minimum": 0
},
"min": {
"type": "integer",
"maximum": 600,
"minimum": 0
}
},
"description": "Months at the current company, e.g. { min: 12, max: 60 }.",
"additionalProperties": false
},
"company_headcount_by_department": {
"type": "array",
"items": {
"type": "object",
"required": [
"department"
],
"properties": {
"max": {
"anyOf": [
{
"type": "integer",
"maximum": 100000,
"minimum": 0
},
{
"type": "null"
}
]
},
"min": {
"anyOf": [
{
"type": "integer",
"maximum": 100000,
"minimum": 0
},
{
"type": "null"
}
]
},
"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",
"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",
"Consulting",
"Consultant",
"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",
"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"
],
"type": "string"
}
},
"description": "One department headcount condition.",
"additionalProperties": false
},
"maxItems": 10,
"description": "Headcount per department, e.g. [{ department: \"Sales\", min: 10, max: 100 }]. Up to 10 entries."
}
},
"description": "Prospeo search filters as flat top-level keys (person_job_title, person_seniority, company_industry, company_headcount_range …); unknown keys are rejected. Reference: https://prospeo.io/api-docs/filters-documentation.",
"additionalProperties": false
}
},
"additionalProperties": false
}json
{
"page": 1,
"filters": {
"company": {
"websites": {
"include": [
"stripe.com"
]
}
},
"person_job_title": {
"include": [
"account executive"
],
"match_mode": "CONTAINS"
},
"person_seniority": {
"include": [
"Senior"
]
}
}
}This Endpoint publishes no output schema. You get the Provider's own response body, unchanged — we do not warrant a shape we cannot guarantee.
How pricing works
| Data returned | Charged only when data is returned. | $0.02695 |
|---|---|---|
| Provider error | The Provider failed to answer. | $0.00 |
| Timed out | The Run exceeded its time limit. | $0.00 |
| Internal failure | An internal error prevented completion. | $0.00 |