Actions11
Overview
The "ProspectPro" node's "Get Many" operation for the "Prospect" resource retrieves multiple prospect records from the ProspectPro API. It is designed to fetch lists of prospects with various filtering, sorting, and pagination options. This node is useful in scenarios where you want to analyze, segment, or export large sets of prospect data based on specific criteria such as tags, owners, qualification status, or activity metrics.
Practical examples include:
- Fetching all qualified prospects created after a certain date.
- Retrieving prospects filtered by specific audiences or tags.
- Getting prospects sorted by last update date in descending order.
- Paginating through large prospect datasets to process them in batches.
Properties
| Name | Meaning |
|---|---|
| Detailed Output | Whether to return detailed output including metadata like the total number of prospects found. Note: Enabling this returns a single item instead of an array of items. |
| Filter Options | Collection of filters to narrow down the prospects returned: - Audience Names or IDs: Filter by one or more audience lists. - Contacts: Filter by presence or absence of contacts. - Created Since: Prospects created after a specified date/time. - Modified Since: Prospects modified after a specified date/time. - Owners Name or ID: Filter by owner. - Qualification Status: Filter by qualified, disqualified, not qualified, or all. - Search: Keyword search. - Tag Names or IDs: Filter by tags. - Website Visits: Filter by presence or absence of website visits. |
| Sorting Options | Collection to define sorting preferences: - Sort By: Choose between Company Name, Last Update Date, or Created Date. - Sort Order: Ascending or Descending. |
| Pagination Options | Collection to control pagination: - Results per Page: Maximum number of results to return. - Page: The page number to retrieve based on the results per page. |
Output
The node outputs JSON data representing the retrieved prospects. Normally, this is an array of prospect objects, each containing details about individual prospects as returned by the ProspectPro API.
If "Detailed Output" is enabled, the output will be a single JSON object that includes additional metadata such as the total number of prospects found, rather than an array of prospect items.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the ProspectPro API.
- The base URL for API requests is
https://api.prospectpro.nl/v1.2. - The node uses query string parameters to pass filter, sorting, and pagination options to the API.
Troubleshooting
- Empty results: Check if your filter criteria are too restrictive or if the page number exceeds available pages.
- Authentication errors: Ensure the API key credential is correctly configured and has necessary permissions.
- Invalid date formats: When using "Created Since" or "Modified Since," ensure dates are valid and properly formatted; the node converts these to UNIX timestamps.
- Unexpected single item output: If "Detailed Output" is enabled, the node returns a single object with metadata instead of an array. Disable this option if you expect multiple prospect items.
- API rate limits: Large queries or frequent calls may hit API rate limits; consider adding delays or reducing result sizes.
Links and References
- ProspectPro API Documentation (hypothetical link)
- n8n Expressions Documentation – for using expressions in property values