search_person

Search Prospeo’s database of professionals using structured filters. Returns up to 25 results per page, paginated across up to 1,000 pages.

Credits: 1 credit per page of results

Parameters

Name	Type	Required	Description
`filters`	object	required	Structured search filters. At least one positive (include) filter is required. See Filter Reference.
`page`	integer	optional	Page number 1-1000. Default: `1`

Person filter keys

Key	Shape	Description
`person_name`	include/exclude	Filter by full name. Max 500 items per array.
`person_name_or_job_title`	string	Free-text search across both name and job title fields.
`person_job_title`	object	`include`, `exclude` arrays + `match_only_exact_job_titles` (boolean) and `boolean_search` (e.g. `"CTO OR (VP AND Engineering)"`).
`person_department`	include/exclude	Functional department, e.g. `"Engineering"`, `"Sales"`, `"Marketing"`.
`person_seniority`	include/exclude	Seniority level: `"C-Suite"`, `"VP"`, `"Director"`, `"Manager"`, `"Senior"`, `"Entry"`, etc.
`person_location_search`	include/exclude	City, region, or country, e.g. `"New York, United States"`.
`person_contact_details`	object	`email` (string[]), `mobile` (string[]), `operator` (`"OR"`/`"AND"`), `hide_people_with_details_already_revealed` (boolean).
`person_year_of_experience`	range	Total years of experience. `min`/`max`, range 0-60.
`person_time_in_current_role`	range	Months in current job title. `min`/`max`, range 0-600.
`person_time_in_current_company`	range	Months at current company. `min`/`max`, range 0-600.
`person_job_change`	object	`timeframe_days`, `only_promotion`, `only_new_company`.
`max_person_per_company`	integer	Cap results per company. Range 1-100.

Company filters (company_industry, company_headcount_range, company_technology, etc.) are also available in search_person to scope results by employer. See the full list in Filter Reference.

Example


{
  "filters": {
    "person_job_title": {
      "include": ["CTO", "VP of Engineering"]
    },
    "person_location_search": {
      "include": ["United States"]
    },
    "company_headcount_range": ["51-100", "101-200"],
    "company_industry": {
      "include": ["Computer Software"]
    }
  },
  "page": 1
}

Response

Search results return a slimmed-down version of each person and company to keep responses concise. Use enrich_person or enrich_company with the returned IDs to get full details (job history, tech stack, descriptions, etc.).


{
  "success": true,
  "data": {
    "results": [
      {
        "person": {
          "person_id": "...",
          "full_name": "...",
          "current_job_title": "...",
          "linkedin_url": "...",
          "email": { "email": "...", "status": "VERIFIED" },
          "mobile": { "status": "VERIFIED", "mobile_country": "..." },
          "location": { "city": "...", "country": "..." }
        },
        "company": {
          "company_id": "...",
          "name": "...",
          "website": "...",
          "industry": "...",
          "employee_range": "...",
          "location": { "city": "...", "country": "..." },
          "linkedin_url": "..."
        }
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 25,
      "total_page": 40,
      "total_count": 987
    }
  }
}