SerpApi Official icon

SerpApi Official

Get live Google Search data and more from SerpApi's official node

Actions72

Overview

The node provides access to live Google News search data via SerpApi's official API. It allows users to perform customized news searches by specifying queries, topics, publications, and other parameters. This node is useful for automating the retrieval of current news articles, monitoring specific topics or publishers, and integrating news data into workflows.

Practical examples include:

  • Fetching the latest news articles about a particular event or keyword.
  • Monitoring news from a specific publisher like CNN or BBC.
  • Retrieving news on a specific topic such as "Technology" or "Business".
  • Sorting news results by relevance or date.
  • Customizing search language and country to get localized news content.

Properties

Name Meaning
Search Query (q) The search term or query string used to find news articles. Cannot be used together with publication_token, story_token, or topic_token.
Additional Fields A collection of optional parameters to refine the search:
- Country (gl) Country code to localize the search (e.g., "us" for United States, "gb" for United Kingdom). See full list of supported countries.
- Language (hl) Language code to specify the language of the search results (e.g., "en" for English, "fr" for French). See full list of supported languages.
- Topic Token Token representing a specific Google News topic (e.g., "World", "Business"). Cannot be used with q, story_token, or publication_token.
- Publication Token Token representing a specific news publisher (e.g., "CNN", "BBC"). Cannot be used with q, story_token, or topic_token.
- Section Token Token representing a subsection of a topic or publication (e.g., "Business -> Economy"). Can only be used with topic_token or publication_token.
- Story Token Token representing a specific news story for full coverage. Cannot be used with q, topic_token, or publication_token.
- Sort By (so) Method to sort results: "Relevance" or "Date".
- Disable Caching Boolean flag to force fetching fresh results instead of cached ones. Cached results expire after 1 hour. Cannot be used with async.
- Async Boolean flag to perform asynchronous search submission. Results must be retrieved later using Search Archive API. Cannot be used with no_cache or on accounts with Ludicrous Speed enabled.
- ZeroTrace Mode Enterprise-only boolean flag to disable storing search parameters and metadata on SerpApi servers for privacy.
- Output Format of the output: "json" for structured JSON (default) or "html" for raw HTML response.
- JSON Restrictor String to restrict fields in the JSON response, e.g., limiting returned fields or number of results.

Output

The node outputs a JSON object containing the search results from Google News according to the specified parameters. The structure typically includes metadata about the search and an array of news articles with details such as title, snippet, source, publication date, and URLs.

If the output format is set to "html", the node returns the raw HTML content of the search results page.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active SerpApi account with a valid API key credential configured in n8n.
  • Internet access to call SerpApi endpoints.
  • No additional environment variables are required beyond the API key credential.

Troubleshooting

  • Conflicting Parameters: Using mutually exclusive parameters together (e.g., q with publication_token) will likely cause errors or unexpected results. Ensure only compatible parameters are combined.
  • API Key Issues: Invalid or missing API key credentials will result in authentication errors. Verify that the API key is correctly configured.
  • Rate Limits and Quotas: Exceeding SerpApi usage limits may cause request failures. Monitor your account usage.
  • Async and No Cache Flags: These two options cannot be used simultaneously. Using both will cause errors.
  • Invalid Tokens: Providing incorrect or expired topic, publication, section, or story tokens may return empty results or errors.
  • Language and Country Codes: Use valid ISO codes as listed; invalid codes may lead to default behavior or errors.

Links and References

Discussion