google_jobs
Read-onlyIdempotent
Retrieve structured job postings (title, company, location, posting age, source) from Google Jobs widget based on a search query.
Instructions
Retrieve parsed Google Jobs listings for a query.
Returns structured job postings (title, company, location, posting age,
source) from the Google Jobs widget for a query.
When to use:
- Aggregating job listings for a role, company, or location
- Labor-market or hiring research
When NOT to use:
- General web or news results (use 'google_search' / 'google_news')
Args:
params (GoogleJobsParams): query (required) plus optional localization
(country_code, gl, hl, uule), pagination (num, start), tld, and
output_format.
Returns:
str: JSON (default) or CSV containing the structured job listings.
Raises:
ToolError: If the API key is missing, the rate limit is exceeded, or
the request fails.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |