DataForSEO icon

DataForSEO

DataForSEO

Overview

The node integrates with the DataForSEO API to retrieve financial exploration data from Google Finance SERP (Search Engine Results Page). Specifically, the "Get Finance Explore" operation fetches curated finance-related news and market information based on a specified location and language. This is useful for users who want to monitor financial news trends, market summaries, or specific types of financial news such as top stories or local/world market updates.

Common scenarios:

  • Financial analysts tracking market news by region.
  • News aggregators compiling finance news feeds.
  • Automated systems updating dashboards with current financial market highlights.

Example use case:
A user configures the node to get "Top Stories" finance news for "United States" in English, enabling them to display up-to-date financial headlines on their website or app.

Properties

Name Meaning
Location Full name of the search engine location to target the finance news (e.g., "United States"). Supported locations are listed in DataForSEO docs.
Language Full name of the search engine language for the results (e.g., "English"). Supported languages are listed in DataForSEO docs.
News Type Type of finance news to retrieve. Options:
- Empty (no filter)
- Top Stories
- Local Market
- World Markets

Output

The node outputs an array of JSON objects representing the finance explore data retrieved from the API. Each object contains structured information about finance news items or market data relevant to the selected location, language, and news type.

  • The json output field includes details such as news headlines, summaries, source information, timestamps, and possibly market indices or stock tickers depending on the response.
  • The node does not explicitly handle binary data output.

Dependencies

  • Requires an active DataForSEO API account with valid API credentials (an API key or token).
  • The node uses the DataForSEO v3 API endpoint at https://api.dataforseo.com/v3.
  • Proper configuration of the API credential in n8n is necessary for authentication.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication errors.
    • Incorrect or unsupported location or language names may result in empty responses or API errors.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • "Something went wrong": A generic error indicating failure during execution; check API credentials, parameters, and network status.
    • Credential-related errors: Ensure the API key/token is correctly set up in n8n credentials.
    • Parameter validation errors: Verify that the location and language values match supported entries from DataForSEO documentation.

Links and References

Discussion