Mandala
Tools

Prospeo

Enrich and search B2B contacts and companies

Usage Instructions

Find verified work emails and mobile numbers, enrich person and company profiles, and search a B2B database of leads and companies using 20+ filters.

Tools

prospeo_account_information

Retrieve the current plan, remaining credits, and renewal date of your Prospeo account.

Input

ParameterTypeRequiredDescription
apiKeystringYesProspeo API key

Output

ParameterTypeDescription
current_planstringCurrent Prospeo plan name
current_team_membersnumberNumber of team members in your team
remaining_creditsnumberNumber of credits remaining
used_creditsnumberNumber of credits already used
next_quota_renewal_daysnumberDays until the next quota renewal
next_quota_renewal_datestringDate and time of the next quota renewal

prospeo_enrich_person

Enrich a person with complete B2B profile data, email address and mobile.

Input

ParameterTypeRequiredDescription
apiKeystringYesProspeo API key
first_namestringNoFirst name of the person
last_namestringNoLast name of the person
full_namestringNoFull name of the person (alternative to first_name + last_name)
linkedin_urlstringNoPerson's public LinkedIn URL
emailstringNoWork email of the person
company_namestringNoCompany name
company_websitestringNoCompany website
company_linkedin_urlstringNoCompany's public LinkedIn URL
person_idstringNoProspeo person_id from a previous Search Person response
only_verified_emailbooleanNoOnly return records with a verified email
enrich_mobilebooleanNoReveal mobile number (10 credits per match; email included)
only_verified_mobilebooleanNoOnly return records that have a mobile (implies enrich_mobile)

Output

ParameterTypeDescription
free_enrichmentbooleanTrue if this enrichment was free (already enriched in the past)
personjsonThe matched person object including person_id, name, linkedin_url, current_job_title, job_history, mobile, email, location, and skills
companyjsonThe current company of the matched person including name, website, domain, industry, employee_count, location, social URLs, funding, and technology

prospeo_enrich_company

Enrich a company with complete B2B data.

Input

ParameterTypeRequiredDescription
apiKeystringYesProspeo API key
company_websitestringNoCompany website (e.g., "intercom.com")
company_linkedin_urlstringNoCompany's public LinkedIn URL
company_namestringNoCompany name (use combined with website for best accuracy)
company_idstringNoProspeo company_id from a previously enriched company

Output

ParameterTypeDescription
free_enrichmentbooleanTrue if this enrichment was free (already enriched in the past)
companyjsonThe matched company object including name, website, domain, industry, employee_count, location, social URLs, funding, and technology

prospeo_bulk_enrich_person

Enrich up to 50 person records at once.

Input

ParameterTypeRequiredDescription
apiKeystringYesProspeo API key
datajsonYesArray of up to 50 person records to enrich. Each must include an "identifier" plus one of: linkedin_url, email, person_id, or (first_name + last_name + company_), or (full_name + company_).
only_verified_emailbooleanNoOnly return records with a verified email
enrich_mobilebooleanNoReveal mobile numbers (10 credits per match; email included)
only_verified_mobilebooleanNoOnly return records that have a mobile (implies enrich_mobile)

Output

ParameterTypeDescription
total_costnumberTotal credits spent by the request
matchedarrayMatched records (identifier, person, company)
not_matchedarrayIdentifiers of records we could not match given the filters
invalid_datapointsarrayIdentifiers of records that did not meet the minimum matching requirements

prospeo_bulk_enrich_company

Enrich up to 50 company records at once.

Input

ParameterTypeRequiredDescription
apiKeystringYesProspeo API key
datajsonYesArray of up to 50 company records to enrich. Each must include an "identifier" plus one of: company_website, company_linkedin_url, company_name, or company_id.

Output

ParameterTypeDescription
total_costnumberTotal credits spent by the request
matchedarrayMatched company records (identifier, company)
not_matchedarrayIdentifiers of records we could not match
invalid_datapointsarrayIdentifiers of records that did not meet the minimum matching requirements

prospeo_search_person

Search for leads using 20+ filters to build targeted contact lists.

Input

ParameterTypeRequiredDescription
apiKeystringYesProspeo API key
filtersjsonYesFilter configuration object. See https://prospeo.io/api-docs/filters-documentation for all supported filters (e.g., person_seniority, company_industry, person_location).
pagenumberNoPage number (defaults to 1). Up to 1000 pages of 25 results.

Output

ParameterTypeDescription
freebooleanTrue if the request was free due to 30-day result-set deduplication
resultsarrayUp to 25 search results (person + company, no email/mobile)
paginationobjectPagination details

prospeo_search_company

Search for companies using 20+ filters to build account lists.

Input

ParameterTypeRequiredDescription
apiKeystringYesProspeo API key
filtersjsonYesFilter configuration object. See https://prospeo.io/api-docs/filters-documentation for all supported filters (e.g., company_industry, company_headcount_range, company_funding).
pagenumberNoPage number (defaults to 1). Up to 1000 pages of 25 results.

Output

ParameterTypeDescription
freebooleanTrue if the request was free due to 30-day result-set deduplication
resultsarrayUp to 25 matching companies
paginationobjectPagination details

prospeo_search_suggestions

Free endpoint to retrieve valid location or job title values for use in Search filters. Provide exactly one of location_search or job_title_search.

Input

ParameterTypeRequiredDescription
apiKeystringYesProspeo API key
location_searchstringNoSearch query for location suggestions (minimum 2 characters). Mutually exclusive with job_title_search.
job_title_searchstringNoSearch query for job title suggestions (minimum 2 characters). Mutually exclusive with location_search.

Output

ParameterTypeDescription
location_suggestionsarrayLocation suggestions when using location_search (empty when searching job titles)
job_title_suggestionsarrayUp to 25 job title suggestions ordered by popularity when using job_title_search (empty when searching locations)

Notes

  • Category: tools
  • Type: prospeo
Prospeo