DataForSEO icon

DataForSEO

DataForSEO

Overview

The node provides access to DataForSEO's API, specifically enabling the search for Google Finance tickers based on a keyword related to a company or financial instrument. This operation is useful for users who want to retrieve financial instrument symbols (tickers) from Google Finance by specifying a company name or other relevant keywords.

Common scenarios include:

  • Financial analysts or developers building apps that need to map company names to their stock tickers.
  • Automated workflows that enrich datasets with financial instrument identifiers.
  • Market research tools that require quick lookup of ticker symbols across various categories like stocks, indices, mutual funds, currencies, and futures.

Example: Searching for the ticker symbol of "Apple" in the US market with English language settings to get the corresponding stock ticker.

Properties

Name Meaning
Keyword Company name or financial instrument to search for.
Location Full name of the search engine location to target the search geographically. Supported locations are listed in the DataForSEO documentation.
Language Full name of the search engine language to use for the search results. Supported languages are listed in the DataForSEO documentation.
Category Category of financial instruments to search for. Options: Empty (no filter), All, Stock, Index, Mutual Fund, Currency, Futures.

Output

The output is a JSON array where each element corresponds to a search result containing information about financial instruments matching the keyword query. The exact structure depends on the DataForSEO API response but typically includes fields such as ticker symbols, company names, exchange details, and possibly additional metadata related to the financial instruments.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active DataForSEO API key credential configured in n8n.
  • Internet access to call the DataForSEO v3 API endpoint at https://api.dataforseo.com/v3.
  • Proper configuration of the node with valid Location and Language parameters according to DataForSEO supported values.

Troubleshooting

  • Invalid or missing API credentials: Ensure the API key credential is correctly set up in n8n.
  • Incorrect Location or Language values: Use only supported full names as per DataForSEO documentation links provided in the property hints.
  • Empty or invalid Keyword: The keyword must be a non-empty string representing a company or financial instrument.
  • API errors or timeouts: Check network connectivity and API usage limits.
  • Unexpected empty results: Verify the category filter and spelling of the keyword; some financial instruments may not be indexed.

Links and References

Discussion