Google Jobs

Description: Enable agents to search for job openings with Google Jobs.

Author: Arcade

Code: GitHub

Auth: API Key

PyPI VersionLicensePython VersionsWheel StatusDownloads

The Arcade Google Jobs toolkit provides a pre-built set of tools for interacting with Google Jobs. These tools make it easy to build agents and AI apps that can:

  • Search for job openings with Google Jobs.

Install

pip install arcade_search

pip installing the toolkit is only needed if you are self-hosting Arcade. You do not need to install the toolkit if you’re using Arcade Cloud.

Available Tools

Tool NameDescription
SearchJobsSearch for job openings with Google Jobs.

If you need to perform an action that’s not listed here, you can get in touch with us to request a new tool, or create your own tools.

SearchJobs


Search for job openings with Google Jobs.

Parameters

  • query (string, required) Search query. Provide a job title, company name, and/or any keywords in general representing what kind of jobs the user is looking for.
  • location (string, optional, Defaults to None) Location to search for jobs. E.g. ‘United States’ or ‘New York, NY’. Defaults to None.
  • language (string, optional, Defaults to ‘en’ English) 2-character language code to use in the Google Jobs search.
  • limit (int, optional, Defaults to 10) Maximum number of results to retrieve. Defaults to 10 (max supported by the API).
  • next_page_token (string, optional, Defaults to None) Next page token to paginate results. Defaults to None (start from the first page).

Auth

The Arcade Google Jobs toolkit uses the SerpAPI to get job data from Google Jobs.

  • Secret:
    • SERP_API_KEY: Your SerpAPI API key.

Setting the SERP_API_KEY secret is only required if you are self-hosting Arcade. If you’re using Arcade Cloud, the secret is already set for you. To manage your secrets, go to the Secrets page in the Arcade Dashboard.

Default parameters

Language is configurable through environment variables. When set, they will be used as default for Google Jobs tools.

Providing a different value as language argument in a tool call will override the default value.

Language

The language code is a 2-character code that determines the language in which the API will search and return news articles. There are two environment variables:

  • ARCADE_GOOGLE_LANGUAGE: a default value for all Google search tools. If not set, defaults to ‘en’ (English).
  • ARCADE_GOOGLE_JOBS_LANGUAGE: a default value for the jobs search tools. If not set, defaults to ARCADE_GOOGLE_LANGUAGE.

A list of supported language codes can be found here.