DataForSEO icon

DataForSEO

DataForSEO

Overview

The node integrates with the DataForSEO API to retrieve financial quote data from Google Finance. Specifically, the "Get Finance Quote" operation fetches detailed stock or security quotes based on a ticker symbol (keyword). This is useful for workflows that require up-to-date financial market data such as stock prices, historical price graphs, and other related financial metrics.

Common scenarios include:

  • Automating financial dashboards by pulling live stock quotes.
  • Triggering alerts or notifications based on stock price changes.
  • Enriching datasets with financial information for analysis or reporting.
  • Integrating financial data into CRM or portfolio management systems.

Example: Fetching the current and historical price data of Apple Inc. (ticker: AAPL) in the US market with English language settings over a 1-day window.

Properties

Name Meaning
Keyword (Ticker or Stock Symbol) The ticker symbol representing the publicly traded shares of a stock or security on a specific stock exchange. Example: "AAPL".
Location Full name of the search engine location to target the query. Determines the geographic context of the financial data. Supported locations are listed in the DataForSEO documentation.
Language Full name of the search engine language to use for the query results. Supported languages are listed in the DataForSEO documentation.
Window Time window for the financial quote graph. Options include: Empty (no window), 1D (1 day), 5D (5 days), 1M (1 month), 6M (6 months), YTD (year to date), 1Y (1 year), 5Y (5 years), MAX (maximum available).

Output

The node outputs an array of JSON objects containing the financial quote data retrieved from the API. The structure typically includes:

  • Current stock price and related metrics.
  • Historical price data points according to the selected time window.
  • Additional financial indicators and metadata relevant to the queried ticker.

If binary data were involved (e.g., charts or images), it would be summarized here, but this node focuses on JSON financial data output.

Dependencies

  • Requires an active DataForSEO API account with valid API credentials (API key/token).
  • The node uses the DataForSEO v3 API endpoint https://api.dataforseo.com/v3.
  • Proper configuration of the API credentials within n8n is necessary for authentication.
  • Network access to the DataForSEO API service must be available.

Troubleshooting

  • Invalid or missing API credentials: Ensure the API key/token is correctly configured in the node credentials. Authentication errors will prevent data retrieval.
  • Unsupported location or language: Using unsupported values for Location or Language properties may cause the API to return errors or empty results. Verify supported values via the DataForSEO documentation links.
  • Invalid ticker symbol: Providing an incorrect or non-existent ticker symbol will result in no data or error responses. Double-check the ticker symbol spelling and validity.
  • Network issues: Connectivity problems can cause request failures. Confirm network access to the DataForSEO API endpoint.
  • Unexpected API errors: If the node throws generic errors ("Something went wrong"), check the API response details if possible, and verify input parameters.

Links and References

Discussion