Overview
The node provides an interface to fetch data from the Explorium API, specifically for two types of entities: Businesses and Prospects. It allows users to retrieve detailed or preview information about companies or people based on various filtering criteria. This node is useful in scenarios such as lead generation, market research, sales prospecting, or enriching CRM data with external business intelligence.
For example:
- Fetch a list of businesses in the US with 11-50 employees and annual revenue between $1M-$5M.
- Retrieve prospects who are managers in the marketing department at companies headquartered in Canada.
- Get lightweight previews or full detailed records depending on the use case.
Properties
| Name | Meaning |
|---|---|
| Type | Select whether to fetch Businesses (companies) or Prospects (people). |
| Mode | Level of detail in returned data: Full (complete data) or Preview (key fields only). |
| Size | Maximum total number of records to return across all pages (1 to 10,000). |
| Page Size | Number of records per page (1 to 100). |
| Page | Page number to retrieve (starting at 1). |
| Country Codes | Filter businesses by headquarters country using ISO alpha-2 codes (e.g., "us", "ca"). Only applies when fetching businesses. |
| Region Country Codes | Filter businesses by region using ISO 3166-2 codes (e.g., "us-ca", "us-tx"). Only for businesses. |
| Cities | Filter businesses by city-level locations (e.g., "San Francisco, CA, US"). Only for businesses. |
| Company Sizes | Filter businesses by employee count ranges (e.g., "1-10", "11-50", ..., "10001+"). Only for businesses. |
| Company Revenue | Filter businesses by annual revenue ranges (e.g., "0-500K", "1M-5M", ..., "10T+"). Only for businesses. |
| Company Age | Filter businesses by years since establishment (e.g., "0-3", "10-15", "20+"). Only for businesses. |
| Google Categories | Filter businesses by Google business categories (free text). Only for businesses. |
| NAICS Categories | Filter businesses by NAICS industry codes (e.g., "23"). Only for businesses. |
| LinkedIn Categories | Filter businesses by LinkedIn business categories (free text). Only for businesses. |
| Tech Stack Categories | Filter businesses by technology categories used (e.g., Marketing, CRM). Only for businesses. |
| Technologies | Filter businesses by specific technologies used (e.g., JavaScript, Apache). Only for businesses. |
| Company Names | Filter businesses by specific company names (e.g., Google, Walmart). Only for businesses. |
| Number of Locations | Filter businesses by number of office locations ("1", "2-5", "6+"). Only for businesses. |
| Website Keywords | Filter businesses by keywords mentioned on their websites (free text). Only for businesses. |
| Business IDs | Filter prospects by specific business IDs. Only for prospects. |
| Job Levels | Filter prospects by job seniority levels (CXO, Director, Entry Level, Manager, Senior). Only for prospects. |
| Job Departments | Filter prospects by job departments (Business Development, Engineering, Finance, HR, Legal, Marketing, Operations, Sales). Only for prospects. |
| Has Email | Filter prospects who have email addresses (true/false). Only for prospects. |
| Has Phone | Filter prospects who have phone numbers (true/false). Only for prospects. |
| Country Codes (Prospect) | Filter prospects by location country using alpha-2 codes. Only for prospects. |
| Company Country Codes (Prospect) | Filter prospects by company HQ country using alpha-2 codes. Only for prospects. |
| Company Sizes (Prospect) | Filter prospects by company employee count ranges. Only for prospects. |
| Company Revenue (Prospect) | Filter prospects by company annual revenue ranges. Only for prospects. |
| Additional Filters (JSON) | Provide additional complex or unlisted filter criteria as JSON. |
| Advanced JSON Input | Use direct JSON input instead of form fields for filters and pagination. |
| JSON Input | JSON object specifying mode, size, page_size, page, and filters for fetching data. Used if Advanced JSON Input is enabled. |
Output
The node outputs a JSON object containing the response from the Explorium API for the requested fetch operation. The structure depends on the type selected:
- For Businesses, the output includes arrays of business records matching the filters, each with fields such as company name, size, revenue, location, categories, technologies, and other enriched data.
- For Prospects, the output contains arrays of people records with details like name, job title, department, contact info (email, phone), company info, and other relevant attributes.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating requests to the Explorium API.
- The node uses HTTP POST requests to endpoints under
https://api.explorium.ai/v1/for fetching data. - Proper configuration of the API authentication credential in n8n is necessary.
Troubleshooting
- Invalid JSON format in JSON Input field: Occurs if the JSON provided in the advanced input is malformed. Fix by ensuring valid JSON syntax.
- At least one company must have an identifier: When matching businesses, ensure that at least one company has identifying info like name or domain.
- At least one prospect must have an identifier: When matching prospects, provide at least one identifier such as email, phone number, or full name.
- At least one business ID is required: For enrichment or events operations requiring business IDs, supply at least one valid ID.
- At least one prospect ID is required: Similarly, for prospect-specific operations needing IDs.
- At least one event type is required: When fetching events, specify at least one event type to query.
- Pagination parameters should be within allowed ranges (page size max 100, size max 10,000).
- Filtering values should conform to expected formats (e.g., country codes as two-letter strings).
Links and References
- Explorium API Documentation (general reference for API endpoints and data models)
- ISO 3166 Country Codes
- NAICS Industry Codes
- LinkedIn Industry Categories
This summary covers the fetch operation of the node for both Businesses and Prospects resources, describing its inputs, outputs, and usage context based on static code analysis and provided property definitions.