SerpApi Official icon

SerpApi Official

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

Actions72

Overview

This node enables users to perform live Google Jobs searches through the SerpApi service. It is designed to retrieve job listings based on a search query and various optional parameters such as location, language, country, and filters like work-from-home options or search radius. This node is beneficial for automating job market research, aggregating job postings, or integrating job search capabilities into workflows.

Practical examples include:

  • Searching for "Barista" jobs in a specific city or region.
  • Filtering job results to only show remote or work-from-home positions.
  • Paginating through job search results using next page tokens.
  • Customizing the search by language or Google domain to target specific markets.

Properties

Name Meaning
Search Query (q) The main search term or job title you want to look for (e.g., "Barista").
Location (location) Geographic location from where the search should originate. See SerpApi's locations API for supported values.
Encoded Location (uule) Google encoded location string for the search. Cannot be used together with the plain location parameter.
Domain (google_domain) Google domain to use for the search, e.g., google.com, google.co.uk, google.de, etc. A long list of country-specific domains is available.
Country (gl) Country code to use for the search, influencing search results localization. Examples: "us", "de", "fr", "jp", etc.
Language (hl) Language code to use for the search interface and results. Examples: "en" (English), "de" (German), "fr" (French), "zh-cn" (Chinese Simplified), etc.
Next Page Token Token to retrieve the next page of results for pagination. Up to 10 results are returned per page.
Chips Deprecated parameter previously used for additional query conditions.
Search Radius (lrad) Search radius in kilometers around the specified location. Does not strictly limit results but influences them.
Work From Home (ltype) Boolean flag to filter results to only those that allow working from home.
Filter Search (uds) Parameter to enable additional filtering of search results. Refer to SerpApi docs for advanced usage.
Disable Caching (no_cache) Boolean flag to force fetching fresh results instead of cached ones. Cached results expire after 1 hour. Cannot be used together with async mode.
Async (async) Boolean flag to perform the search asynchronously. If true, the search is submitted and results must be retrieved later via the 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 (output) Defines the output format: "json" (default) for structured JSON results or "html" for raw HTML response.
JSON Restrictor Allows restricting fields in the JSON response to reduce data size, e.g., limiting to certain result fields or number of items.

Output

The node outputs a JSON object containing the search results from Google Jobs as returned by SerpApi. The structure includes job listings and associated metadata such as job titles, company names, locations, snippets, posting dates, and more depending on the query and parameters.

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 involved in this operation.

Dependencies

  • Requires an active SerpApi account and an API key credential configured in n8n.
  • Internet access to call the SerpApi endpoint at https://serpapi.com/search.json.
  • Proper configuration of the API key credential in n8n to authenticate requests.

Troubleshooting

  • Invalid API Key or Authentication Errors: Ensure the API key credential is correctly set up and valid.
  • Conflicting Parameters: Do not use both location and uule parameters simultaneously; they are mutually exclusive.
  • Pagination Issues: When using next_page_token, ensure it is correctly obtained from previous responses and passed exactly.
  • Async and No Cache Conflict: Do not enable both async and no_cache flags together; they are incompatible.
  • Rate Limits or Quotas: Exceeding SerpApi usage limits may cause errors; monitor your account usage.
  • Empty or Unexpected Results: Verify that the search query and parameters are valid and supported by SerpApi.
  • ZeroTrace Mode: Enabling this mode may make debugging difficult due to lack of stored metadata.

Links and References

Discussion