Google Jobs search
Search Google's public careers site and pull one posting's full detail — description, responsibilities, and qualifications — as normalized JSON from the Crawlora API, no scraping careers.google.com by hand.
When to use this skill
- "Search for jobs at Google in ."
- "What is Google currently hiring for in <team/location>?"
- "Pull the full detail (description, responsibilities, qualifications) for Google job id ."
- "Track new Google Jobs postings for over time."
Setup (one-time)
- Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
- Set
CRAWLORA_API_KEYin the environment before running the helper. - The helper reads
CRAWLORA_API_KEYfrom the environment and sends requests tohttps://api.crawlora.net/api/v1. Missing/invalid key →401.
How it works
- Search —
/google-jobs/searchtakes a requiredq(search query), plus optionallocation(free text) andpage(1-based). It parses careers.google.com's server-rendered search page's embedded job data, so each result already includes the description, responsibilities, and qualifications inline — no second call needed just to read a listing. Page size is fixed by Google at 20 results; passpageto walk further pages. - Job detail —
/google-jobs/jobtakes the requiredid(the numeric Google job id returned by search) and re-fetches that single posting's full server-rendered detail page. Use it to refresh one posting or to fetch a job by id when you already have it from elsewhere (e.g. a saved link).
Full endpoint list, methods, and params: reference/endpoints.md.
Calling the API
# Search:
scripts/crawlora.sh /google-jobs/search q="software engineer" location="Mountain View" | jq '.'
# Job detail by id:
scripts/crawlora.sh /google-jobs/job id=123456789012345 | jq '.'
Use scripts/crawlora.sh for all requests; it keeps the API key out of command-line arguments.
Endpoint reference
See reference/endpoints.md for both Google Jobs
endpoints this skill uses.
Examples
- Role search in a location:
/google-jobs/searchwithq="data scientist"andlocation="New York", paging withpage=2,page=3to collect more than 20 results. - Track a specific posting: save the
idfrom a search result, then poll/google-jobs/jobfor thatidon a schedule to detect edits or removal (a404/empty response signals the posting closed).
Notes & limits
- Credits / pay-on-success: billed only on
2xx; free tier 2,000 credits/mo. Key at https://crawlora.net. - Public data only — public careers.google.com postings; respect Google's terms.
- Security: key lives in
CRAWLORA_API_KEYonly — never hardcode, query-param, or commit it. - Page size is fixed at 20 by Google — there's no
limit/per_pageparam, onlypageto move through results. idmust be the numeric Google job id from a search result'sidfield, not a slug or URL.