Outscraper icon

Outscraper

Interact with Outscraper API

Actions49

Overview

The Google Search - Search News operation in this node allows users to perform news searches using the Outscraper API. It enables querying for news articles based on a search term, with options to control pagination, language, region, date range, and other parameters. This is useful for gathering recent news articles related to specific topics, monitoring media coverage, or aggregating news content for analysis.

Practical examples include:

  • Monitoring news about a brand or product by searching relevant keywords.
  • Collecting recent news articles within a certain date range (e.g., past week).
  • Filtering news results by language or geographic region to get localized news.

Properties

Name Meaning
Query The search query string to find relevant news articles.
Pages Per Query Number of pages of results to return per query (controls how many results are fetched).
Async Request Whether to make the request asynchronously (true/false).
Webhook URL to which Outscraper will send a POST request once the task is finished (for async processing).
Language Language code for the search results (e.g., "en" for English, "fr" for French).
Additional Fields Collection of optional fields:
- Date Range Filter news results by date range: Past Hour, Past 24 Hours, Past Week, Past Month, Past Year.
- Fields Specific fields to return in the response, comma-separated.
- Region Country code to localize results (e.g., "us", "uk", "fr").
- Skip Number of results to skip (useful for pagination).
- UULE Parameter Google UULE parameter to encode a specific location for more precise geolocation-based results.

Output

The node outputs JSON data containing the search results from the Outscraper API. The structure typically includes an array of news articles matching the query, each with details such as title, snippet, source, publication date, and URL. If asynchronous mode is used, the output may initially contain task status information, and the final results will be sent to the specified webhook URL.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active Outscraper API key credential configured in n8n.
  • The node sends requests to the Outscraper API endpoint specified in credentials.
  • For asynchronous requests, a publicly accessible webhook URL must be provided to receive callbacks.

Troubleshooting

  • Common issues:

    • Missing or invalid API key will cause authentication errors.
    • Incorrect or empty query string will result in no results or errors.
    • Providing an invalid webhook URL when async is enabled may cause callback failures.
    • Exceeding API rate limits or quota can lead to request rejections.
  • Error messages:

    • Authentication errors: Check that the API key credential is correctly set up.
    • Validation errors: Ensure required fields like "Query" are not empty.
    • Network errors: Verify internet connectivity and API endpoint accessibility.
    • Async callback failures: Confirm webhook URL is reachable and accepts POST requests.

Links and References

Discussion