DataForSEO icon

DataForSEO

DataForSEO

Overview

The node integrates with the DataForSEO API to perform various SEO and financial data retrieval operations. Specifically, for the Search Google Finance Tickers operation under the SERP resource, it allows users to search for financial instruments or companies by keyword on Google Finance. This is useful for obtaining ticker symbols and related financial instrument categories based on a company name or other keywords.

Practical scenarios include:

  • Automatically retrieving ticker symbols for companies mentioned in content.
  • Enriching datasets with financial instrument identifiers for further analysis.
  • Building financial dashboards that require mapping company names to their tickers.

Properties

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

Output

The node outputs an array of JSON objects representing the search results from Google Finance tickers matching the input keyword and filters. Each object typically contains details about a financial instrument such as its ticker symbol, name, category, and possibly additional metadata returned by the DataForSEO API.

If the node supports binary data output (not explicitly shown here), it would represent downloadable or raw data related to the search results, but this operation primarily returns structured JSON data.

Dependencies

  • Requires an active DataForSEO API key credential configured in n8n.
  • The node makes POST requests to the DataForSEO v3 API endpoint (https://api.dataforseo.com/v3).
  • Proper configuration of location and language parameters according to DataForSEO's supported values is necessary.

Troubleshooting

  • Invalid or missing API credentials: Ensure the DataForSEO API key is correctly set up in n8n credentials.
  • Unsupported location or language: Use only supported location and language names as per DataForSEO documentation links provided in the property hints.
  • Empty or invalid keyword: The keyword property is required; ensure it is not empty and correctly spelled.
  • API rate limits or quota exceeded: If the API returns errors related to usage limits, consider upgrading your DataForSEO plan or reducing request frequency.
  • Unexpected response structure: Verify that the operation and resource parameters are correctly selected; mismatches can cause errors.

Links and References

Discussion