start_job_search
Initiates a Google Jobs search and returns a run_id; pass it to get_job_results to fetch listings, salary data, descriptions, and apply links.
Instructions
Start a Google Jobs search and return a run_id immediately. Step 1 of 2: then call get_job_results(run_id) to get the listings (title, company, location, salary, posted date, full job description and the real apply URLs).
Starts the hosted Apify Actor "datalume/google-jobs-scraper" with your own Apify
account. Requires the APIFY_TOKEN environment variable. It is PAID per unique job
saved (current price: https://apify.com/datalume/google-jobs-scraper ); searches with
no results and blocked pages are not charged. Starting a search spends money even if
the results are never fetched, so start one only when the user wants job data. The
run stops at max_jobs and at max_total_charge_usd. Every query is searched in every
location; one search takes about a minute (19 Nov 2026: 59 s with "fast" coverage).
Args:
queries: job titles, skills or companies, e.g. ["registered nurse"].
locations: cities, regions or countries, e.g. ["Houston, TX"]. Empty = no location.
country: 2-letter country Google searches from, e.g. "us", "gb", "de", "in".
language: Google language code. Use the local language outside English-speaking countries.
date_posted: "any", "today", "3days", "week" or "month".
employment_type: "any", "fulltime", "parttime", "contract" or "internship" (English searches).
remote_only: remote / work-from-home jobs only (English searches).
coverage: requests per search: "fast" (3), "standard" (9) or "max" (13). More requests = more unique jobs and a longer run.
max_jobs: stop after this many jobs in total. Keep small to control cost and response size.
max_total_charge_usd: hard spending cap for this search, in USD.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"queries": "<queries>"
},
"name": "start_job_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | us | |
| queries | Yes | ||
| coverage | No | fast | |
| language | No | en | |
| max_jobs | No | ||
| locations | No | ||
| date_posted | No | any | |
| remote_only | No | ||
| employment_type | No | any | |
| max_total_charge_usd | No |