Overview
This node integrates with the Horizon Data Wave Job Boards API to search for job listings on Glassdoor. It allows users to query Glassdoor's job database using keywords and various filters, returning a list of relevant job postings.
Common scenarios where this node is beneficial include:
- Automating job market research by fetching up-to-date job listings matching specific criteria.
- Integrating job search capabilities into recruitment workflows or HR tools.
- Monitoring new job openings in particular locations, companies, or job types.
Practical example:
- A recruiter wants to find all "Software Engineer" jobs in New York posted within the last 24 hours that allow remote work and have an "Easy Apply" option. This node can be configured with those filters to retrieve matching listings automatically.
Properties
| Name | Meaning |
|---|---|
| Keyword | Search keyword for job titles or descriptions, e.g., "Software Engineer". Required. |
| Count | Number of job listings to return per page. Accepts values from 1 to 100. Default is 20. |
| Timeout | Request timeout in seconds. Must be between 20 and 1500. Default is 300 seconds. |
| Additional Filters | Collection of optional filters to refine the job search: |
| - Location | Name of the location (city or state), e.g., "New York". Used when searching within a specific city or state. |
| - Location ID | Internal Glassdoor location identifier (usually not set manually). |
| - Location Type | Type of location: City, State, or Country. Options: City (1), State (2), Country (3). Default is City. |
| - Country | Country domain for Glassdoor search. Options include USA, Australia, Germany, UK, Canada, France, Japan, India, Brazil, Spain, Italy, Netherlands, Switzerland, Austria, Belgium, Sweden, Singapore, Hong Kong, Mexico, Ireland. Default is USA. |
| - Page | Pagination page number from 1 to 10. Default is 1. |
| - Company Size | Filter by company size. Options: Any Size (0), 1-200 Employees (1), 201-500 Employees (2), 501-1000 Employees (3), 1000-5000 Employees (4), 5000+ Employees (5). Default is Any Size. |
| - Remote Only | Boolean flag to filter only remote jobs. Default is false. |
| - Hours Old | Show job listings published in the last X hours. Numeric value. |
| - Easy Apply | Boolean flag to filter jobs that support "Easy Apply". Default is false. |
| - Job Type | Job type string, e.g., "fulltime", "parttime", supporting international variants. |
Output
The node outputs an array of JSON objects, each representing a job listing retrieved from Glassdoor. The exact structure depends on the API response but typically includes details such as job title, company name, location, posting date, job description snippet, and application options.
If the API returns multiple job listings, each is output as a separate item in the node's output array.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for the Horizon Data Wave Job Boards API.
- The node makes authenticated HTTP POST requests to
https://api.horizondatawave.ai/api/glassdoor/joblist. - Proper configuration of the API credentials in n8n is necessary before use.
Troubleshooting
- Missing Credentials: If no API credentials are provided or the account ID is missing in the credentials, the node will throw an error. Ensure that valid credentials with an account ID are configured.
- Timeout Issues: Setting the timeout outside the allowed range (20-1500 seconds) may cause request failures or unexpected behavior.
- Invalid Filter Values: Providing invalid values for filters like country codes, location types, or company sizes may result in API errors.
- API Errors: The node captures detailed API error information including HTTP status, error messages, request IDs, and execution times. Review these details to diagnose issues such as rate limiting, invalid parameters, or server errors.
- Pagination Limits: The page parameter supports values from 1 to 10. Requests beyond this range may not return results.
To resolve common errors:
- Verify all required parameters are set correctly.
- Check API credential validity and permissions.
- Adjust timeout and pagination settings within allowed ranges.
- Consult API error details included in the node output if "Continue On Fail" is enabled.
Links and References
- Glassdoor Job Listings API Documentation (Note: Actual API docs for Horizon Data Wave integration may differ; consult your API provider.)
- Horizon Data Wave Job Boards API (base URL used by the node)
- n8n Documentation on HTTP Request Node for understanding underlying HTTP calls