SerpApi Official icon

SerpApi Official

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

Actions72

Overview

This node integrates with SerpApi's Google Jobs API to perform live job search queries on Google. It allows users to retrieve structured job listings based on a search query and various optional parameters such as location, language, and filters like work-from-home options.

Common scenarios where this node is beneficial include:

  • Automating job market research by fetching current job openings matching specific criteria.
  • Integrating job search results into recruitment platforms or dashboards.
  • Monitoring job trends in particular locations or industries.

For example, a user can search for "Barista" jobs in "New York" with a 10 km radius, filtering for remote work options, and receive structured JSON data of relevant job postings.

Properties

Name Meaning
Search Query (q) The main search term or job title you want to look for (e.g., "Barista"). This is required.
Location (location) The geographic location from which the search should originate. Supports various location names as per SerpApi's locations API.
Encoded Location (uule) Google encoded location string for the search. Cannot be used together with the plain location parameter.
Domain (google_domain) The Google domain to use for the search (e.g., google.com, google.co.uk). A long list of country-specific Google domains is available.
Country (gl) The country code to use for the Google search (e.g., "us" for United States, "de" for Germany). Many language and country codes are supported.
Language (hl) The language code to use for the search interface and results (e.g., "en" for English, "fr" for French).
Next Page Token Token to fetch the next page of results when paginating through job listings. Up to 10 results are returned per page.
Chips (chips) Deprecated parameter that previously defined additional query conditions.
Search Radius (lrad) Defines the search radius in kilometers around the specified location. Does not strictly limit the radius but influences result proximity.
Work From Home (ltype) Boolean flag to filter results by work-from-home jobs.
Filter Search (uds) Enables additional filtering of search results. See SerpApi documentation for advanced usage.
Disable Caching (no_cache) Boolean flag to force fresh results from SerpApi instead of cached ones. Cached results expire after 1 hour and do not count against monthly search limits. Cannot be used with async mode.
Async (async) Boolean flag to perform the search asynchronously. When true, the search is submitted and results must be retrieved later via the Search Archive API. Cannot be used with no_cache and not recommended for accounts with Ludicrous Speed enabled.
ZeroTrace Mode (zero_trace) Enterprise-only boolean flag to disable storing search parameters and metadata on SerpApi servers for privacy. May make debugging more difficult.
Output (output) Defines the output format: "json" (default) returns structured JSON results; "html" returns raw HTML of the search results.
JSON Restrictor Allows restricting the fields returned in the JSON response, e.g., limiting to certain result fields or number of items.

Output

The node outputs a JSON object containing the structured results of the Google Jobs search query. This includes job listings with details such as job title, company, location, description, posting date, and other metadata provided by SerpApi.

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

No binary data output is involved.

Dependencies

  • Requires an active SerpApi account and a valid API key credential configured in n8n.
  • The node sends HTTP requests to SerpApi's endpoint https://serpapi.com/search.json with appropriate query parameters.
  • No additional external dependencies beyond the API key and internet connectivity.

Troubleshooting

  • Invalid API Key or Authentication Errors: Ensure the API key credential is correctly configured and has permissions for Google Jobs API access.
  • Empty or Unexpected Results: Verify that the search query (q) and location parameters are correctly set. Using incompatible parameters like both location and uule simultaneously will cause errors.
  • Pagination Issues: When using next_page_token, ensure tokens are valid and not expired. Tokens allow fetching subsequent pages of results.
  • Caching Conflicts: Do not use no_cache and async parameters together as they are mutually exclusive.
  • Async Mode Usage: If async is enabled, results are not immediately available and must be fetched later via the Search Archive API, which requires additional handling outside this node.
  • ZeroTrace Mode: Enabling this may reduce debugging information if issues arise.
  • Rate Limits and Quotas: Exceeding SerpApi usage limits will result in errors; monitor your account usage accordingly.

Links and References

Discussion