Finnhub.io

Consume Finnhub.io API

Actions26

Overview

This n8n node interacts with the Finnhub.io API, specifically targeting the "Alternative" resource and its "H1-B Visa Application" operation. It allows users to retrieve data related to H1-B visa applications for a specified company within a given date range. This can be useful for HR analytics, market research, or compliance monitoring where understanding a company's visa sponsorship activity is relevant.

Example scenarios:

An HR analyst wants to track how many H1-B visa applications a tech company has filed over the past year.
A market researcher analyzes trends in foreign talent hiring by public companies.
A compliance officer monitors visa application activities for regulatory reporting.

Properties

Name	Type	Meaning
Symbol	String	Company symbol (e.g., "GME") used to identify the target company.
From Date	DateTime	Start date for the visa application data query.
To Date	DateTime	End date for the visa application data query.

Output

The node outputs a JSON object containing information about H1-B visa applications for the specified company and date range. The exact structure depends on the Finnhub.io API response, but typically includes fields such as:

Year
Number of applications
Status (approved/denied)
Job titles
Locations

Note: The node does not output binary data.

Dependencies

External Service: Requires access to the Finnhub.io API.
API Key: You must provide a valid Finnhub API key via n8n credentials named finnhub.
n8n Configuration: Ensure the Finnhub credential is set up in your n8n instance.

Troubleshooting

Missing or Invalid API Key:
Error message: "401 Unauthorized" or similar.
Resolution: Check that your Finnhub API key is correctly configured in n8n credentials.
Invalid Company Symbol:
Error message: "404 Not Found" or empty results.
Resolution: Verify the company symbol is correct and supported by Finnhub.
Date Range Issues:
Error message: "400 Bad Request" or no data returned.
Resolution: Ensure "From Date" and "To Date" are valid and in the correct format.
API Rate Limits:
Error message: "429 Too Many Requests".
Resolution: Wait before making more requests or upgrade your Finnhub plan.