Google Jobs API

Our Google Jobs API allows you to scrape SERP results from a Google Jobs search. The API is accessed through the following endpoint: /search?engine=google_jobs. A user may query the following: https://serpapi.com/search?engine=google_jobs utilizing a GET request. Head to the playground for a live and interactive demo.

API Parameters

Search Query

q

Required

Parameter defines the query you want to search.

Geographic Location

location

Optional

Parameter defines from where you want the search to originate. If several locations match the location requested, we'll pick the most popular one. Head to the /locations.json API if you need a more precise control. location and uule parameters can't be used together. Avoid utilizing location when setting the location outside the U.S. when using Google Shopping and/or Google Product API.

uule

Optional

Parameter is the Google encoded location you want to use for the search. uule and location parameters can't be used together.

Localization

google_domain

Optional

Parameter defines the Google domain to use. It defaults to google.com. Head to the Google domains for a full list of supported Google domains.

gl

Optional

Parameter defines the country to use for the Google search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France) Head to the Google countries for a full list of supported Google countries.

hl

Optional

Parameter defines the language to use for the Google Jobs search. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French) Head to the Google languages for a full list of supported Google languages.

Pagination

start

Optional

Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.).

Advanced Google Jobs Parameters

chips

Optional

Parameter defines additional query conditions. Top of a job search page contains elements called chips, its values are extracted in order to be passed to chips parameter. E.g. city:Owg_06VPwoli_nfhBo8LyA== will return results for New York.

lrad

Optional

Defines search radius in kilometers. Does not strictly limit the radius.

Serpapi Parameters

engine

Required

Set parameter to google_jobs to use the Google Jobs API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the Google Jobs results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

API Results

JSON Results

JSON output includes structured data for jobs_results - actual search results and chips - data extracted from the top of the job search page and can be used detailed query.

A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.

HTML Results

HTML output is useful to debug JSON results or support features not supported yet by SerpApi.
HTML output gives you the raw HTML results from Google.

API Examples

Example with q: barista new york

Example with q: barista new york

JSON Example

{
  "search_metadata": {
    "id": "6141f80294c6c73079b813d5",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/e367321776e28456/6141f80294c6c73079b813d5.json",
    "created_at": "2021-09-15 13:41:22 UTC",
    "processed_at": "2021-09-15 13:41:22 UTC",
    "google_jobs_url": "https://www.google.com/search?q=barista+new+york&ibp=htl;jobs&hl=en",
    "raw_html_file": "https://serpapi.com/searches/e367321776e28456/6141f80294c6c73079b813d5.html",
    "total_time_taken": 1.13
  },
  "search_parameters": {
    "q": "barista new york",
    "engine": "google_jobs",
    "google_domain": "google.com",
    "hl": "en"
  },
  "jobs_results": [
    {
      "title": "Barista",
      "company_name": "Split Eights",
      "location": "New York, NY",
      "via": "via Culinary Agents",
      "description": "Currently hiring part-time baristas, with potential to grow into a full-time position, for a coffee and cocktail bar located in the Financial District. We are seeking knowledgeable and experienced baristas for our coffee program, to assist customers with consistently efficient and warm service, craft balanced quality Parlor Coffee drinks, and create a neighborhood spot for commuters and residents alike.Duties & Responsibilities to Include:• Preparing specialty beverages and maintaining quality control, in accordance with the standards of third-wave espresso, coffee, and tea service; occasional coffee-cocktail, beer, and wine service• Assisting in cash-handling, customer transactions, stocking, cleaning and clearing, and other general café duties• Providing excellent service, equipped with knowledge of the product and establishing the customer experience...",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQQQJhPafs1fr8dGF4A8mGSQU6BjUFFu8o0ExUWT4o&s",
      "extensions": [
        "23 days ago",
        "Full-time",
        "No degree mentioned"
      ],
      "detected_extensions": {
        "posted_at": "23 days ago",
        "schedule_type": "Full-time"
      },
      "job_id": "eyJqb2JfdGl0bGUiOiJCYXJpc3RhIiwiaHRpZG9jaWQiOiJZX2ZDRGtSZFFfWUN5RTN4QUFBQUFBPT0iLCJobCI6ImVuIiwiYXBwbHlfbGluayI6eyJ0aXRsZSI6IkFwcGx5IG9uIEN1bGluYXJ5IEFnZW50cyIsImxpbmsiOiJodHRwczovL2N1bGluYXJ5YWdlbnRzLmNvbS9qb2JzLzI2MzQyNi1CYXJpc3RhP2NsaWVudF9pZD1DQS1JTi1SRUxBVEVESk9CUzE3XHUwMDI2d2lkZ2V0X25hbWU9am9iLWRldGFpbFx1MDAyNnV0bV9jYW1wYWlnbj1nb29nbGVfam9ic19hcHBseVx1MDAyNnV0bV9zb3VyY2U9Z29vZ2xlX2pvYnNfYXBwbHlcdTAwMjZ1dG1fbWVkaXVtPW9yZ2FuaWMifX0="
    },
    {
      "title": "Barista / Cafe Staff",
      "company_name": "Oslo Coffee 42 West 42nd",
      "location": "New York, NY",
      "via": "via Good Food Jobs.",
      "description": "Make delicious coffee drinks and light food. Work with care and attention. Help make people feel welcome. Very good tips!",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTlFfG9qmnD1tQAWNGB11kMsqbujiT8MdywZG6Awl0&s",
      "extensions": [
        "28 days ago",
        "Part-time",
        "No degree mentioned"
      ],
      "detected_extensions": {
        "posted_at": "28 days ago",
        "schedule_type": "Part-time"
      },
      "job_id": "eyJqb2JfdGl0bGUiOiJCYXJpc3RhIC8gQ2FmZSBTdGFmZiIsImh0aWRvY2lkIjoicWVvTEdqRXlWWm1LQmN1Z0FBQUFBQT09IiwiaGwiOiJlbiIsImFwcGx5X2xpbmsiOnsidGl0bGUiOiJBcHBseSBvbiBHb29kIEZvb2QgSm9icy4iLCJsaW5rIjoiaHR0cHM6Ly93d3cuZ29vZGZvb2Rqb2JzLmNvbS9qb2JzLzE0NTY1MC9iYXJpc3RhLWNhZmUtc3RhZmYuaHRtbD91dG1fY2FtcGFpZ249Z29vZ2xlX2pvYnNfYXBwbHlcdTAwMjZ1dG1fc291cmNlPWdvb2dsZV9qb2JzX2FwcGx5XHUwMDI2dXRtX21lZGl1bT1vcmdhbmljIn19"
    },
    {
      "title": "Barista",
      "company_name": "Blue Bottle Coffee",
      "location": "Brooklyn, NY",
      "via": "via LinkedIn",
      "description": "At Blue Bottle, our mission is to connect the world to delicious coffee. From seed to cup, we elevate the craft of coffee in everything we do. We strive to build a better tomorrow by investing in what matters: a sustainable future for our people, the company, and our planet.About The JobAt Blue Bottle Coffee, a Barista is someone who is passionate about coffee, culinary items, sustainability, and creating incredible guest experiences grounded in care and respect. We invite you to grow as a team member and create community through coffee with us.You will• Deliver exceptional hospitality to our guests, your fellow teammates, and all of our vendors and suppliers• Make and serve a selection of delicious beverages with a variety of different brewing and preparation methods• Prepare and serve delicious food• Stay knowledgeable about Blue Bottle’s current beverage and food offerings and preparation techniques; continuously cultivating your own curiosity and knowledge through...",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQjQSWUzL6xBUAe24a8UZ1klyGNMh6ADHUClkrTiW0&s",
      "extensions": [
        "Over 1 month ago",
        "Full-time",
        "No degree mentioned"
      ],
      "detected_extensions": {
        "posted_at": "Over 1 month ago",
        "schedule_type": "Full-time"
      },
      "job_id": "eyJqb2JfdGl0bGUiOiJCYXJpc3RhIiwiaHRpZG9jaWQiOiJXQ1BweGVKeVVLMjNCQy1zQUFBQUFBPT0iLCJobCI6ImVuIiwiZmMiOiJFdmNCQ3JjQlFVMXNkbkp3ZEhSV1pHbGxWR1pzYXpOdVNVNUhOVGxyVjNWaVVIRkZiM1UyYmxOemMwNVZTazlKVEZSRWRFWnRSRkZ5VTNwUlZ6RjVTMGg1V21ORGVHbG1iRXhIZGtkUVNUYzJUVzlXVlhSVmMwcEdUa0pHTVhSbE1rTlNWVVJDUW5oNFdYZENkSFZMTVRkR1RrODBjM0E0VUhCdVJrbE1TeTFYTVU1bmVGRlNabEZGZW1GR1pWSjVURlZXYkhONkxYRndjbVEyWVRoQ1FuUmhlR290U1dWSlYwczJNbEJ3TmxwM09XcHBUMGh1UzFKcU1qaDNFaGRDVUdoQ1dXRjZWRWhQZFhkeGRITlFlV054TldkQlp4b2lRVWhYVTA1dFZtbElTV2R4Y1ZWRFF6RXpjRXAxZDBsUVVFVTRZVkpQUkVWSFp3IiwiZmN2IjoiMyIsImZjX2lkIjoiZmNfMTkiLCJhcHBseV9saW5rIjp7InRpdGxlIjoiQXBwbHkgb24gTGlua2VkSW4iLCJsaW5rIjoiaHR0cHM6Ly93d3cubGlua2VkaW4uY29tL2pvYnMvdmlldy9iYXJpc3RhLWF0LWJsdWUtYm90dGxlLWNvZmZlZS0yNjg2NTcwNDk4P3V0bV9jYW1wYWlnbj1nb29nbGVfam9ic19hcHBseVx1MDAyNnV0bV9zb3VyY2U9Z29vZ2xlX2pvYnNfYXBwbHlcdTAwMjZ1dG1fbWVkaXVtPW9yZ2FuaWMifX0="
    },
    ...
  ],
  "chips": [
    {
      "type": "Title",
      "param": "job_family_1",
      "options": [
        {
          "text": "All"
        },
        {
          "text": "Barista",
          "value": "barista"
        },
        {
          "text": "Attendant",
          "value": "attendant"
        },
        ...
      ]
    },
    {
      "type": "Location",
      "param": "city",
      "options": [
        {
          "text": "All"
        },
        {
          "text": "New York, NY",
          "value": "Owg_06VPwoli_nfhBo8LyA=="
        },
        {
          "text": "New Rochelle, NY",
          "value": "tVa61YmNwomi2n5qO8N6zw=="
        },
        ...
      ]
    },
    {
      "type": "Date posted",
      "param": "date_posted",
      "options": [
        {
          "text": "All"
        },
        {
          "text": "Past day",
          "value": "today"
        },
        {
          "text": "Past 3 days",
          "value": "3days"
        },
        ...
      ]
    },
    ...
  ]
}

Example with q: barista and chips: date_posted:week,city:Owg_06VPwoli_nfhBo8LyA==

To specify the query chips parameter can be used. Chips structure: param:value,param:value. Multiple params and values can be used and could be combined. Next example shows results for "barista", date posted "Past week" and location "New York".
Example with q: barista and chips: date_posted:week,city:Owg_06VPwoli_nfhBo8LyA==

JSON Example

{
  "search_metadata": {
    "id": "6141f8d594c6c77aaa5d631b",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/ff20f81e6713fd29/6141f8d594c6c77aaa5d631b.json",
    "created_at": "2021-09-15 13:44:53 UTC",
    "processed_at": "2021-09-15 13:44:53 UTC",
    "google_jobs_url": "https://www.google.com/search?q=barista&ibp=htl;jobs&hl=en&chips=date_posted:week,city:Owg_06VPwoli_nfhBo8LyA==",
    "raw_html_file": "https://serpapi.com/searches/ff20f81e6713fd29/6141f8d594c6c77aaa5d631b.html",
    "total_time_taken": 0.98
  },
  "search_parameters": {
    "q": "barista",
    "engine": "google_jobs",
    "google_domain": "google.com",
    "hl": "en",
    "chips": "date_posted:week,city:Owg_06VPwoli_nfhBo8LyA=="
  },
  "jobs_results": [
    {
      "title": "BARISTA (FULL-TIME)",
      "company_name": "Chartwells Higher Education Dining Services",
      "location": "New York, NY",
      "via": "via LinkedIn",
      "description": "Posted Date: Sep 14, 2021• We are hiring immediately for a full-time BARISTA position.• Location: New York University; 45 West 4th Street, Manhattan, NY 10012 Note: online applications accepted only.• Schedule: Full-time; Schedule to be determined. Nights and weekend availability is preferred.• Requirement: Prior barista experience is required!• Internal Employee Referral Bonus AvailableAt colleges and universities around the country, Chartwells Higher Education is re-inventing the on-campus dining experience. We are challenging the norm and setting new standards by investing in high-tech, food-infused social spaces that bring people together to promote meaningful relationships and interactions. We are food-forward difference makers, bound together by a desire to feed hungry minds and prepare students for success.With over 300 campuses around the country, we are seeking hungry, humble and smart associates who are looking to join and grow with a diverse organization. We invite...",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCTv_TuT2BgtQPGvWHy_6Dq0aCrRDfUKsbVMl067o&s",
      "extensions": [
        "14 hours ago",
        "Full-time"
      ],
      "detected_extensions": {
        "posted_at": "14 hours ago",
        "schedule_type": "Full-time"
      },
      "job_id": "eyJqb2JfdGl0bGUiOiJCQVJJU1RBIChGVUxMLVRJTUUpIiwiaHRpZG9jaWQiOiJrUk9SVUtZaGZSSWRxT3VCQUFBQUFBPT0iLCJobCI6ImVuIiwiZmMiOiJFcmNDQ3ZjQlFVMXNkbkp3ZEU1TWJqZFFNRGxoUWtSUFpWbG1Na1l6TURWSFRscGxRWEJuYUhoVVl6RnFRMjlOU0VodE9WbHRNVUZvVkc0M1RUazVVVGxITm1NdE9WRmlPREZ2Vm1sdFpreEhTMGxzVUdWVmRFZElSbGwxUXprd1pVNTRhVXRpZVY4NE1HeHRTRTFoVUhaNVIyTkZlbVp1VGxNMFNVVjFUSE5RUWxKSVp6VnZkbUpXWTJscldHNTZUalJ1YTNnelZHVlZjR3d3T0Y5WFowWnZiVzlMYkV4UGNrSnFNM0V5Vm1vNFprczNlbmxPUjNSdVFWWmZjelZCV25Wdk5FUktXVmxVVUZGdFRGWmtObG93VDNwT1IwWXlVVFZZYUVVd2RqWk5SRVp5YUU1M1Uyd3ljMDQ1U1ZkRlYzUlhXSFk0VFZoMmN6STRWUklYTVY5b1FsbGlhV3BKVDBNM2NYUnpVR3hsVTJOblFXY2FJa0ZJVjFOT2JWWjZSbVZST0RKdGQyZEZlRWxtTmtsM1QxTjRUV05SVTA5dGNsRSIsImZjdiI6IjMiLCJmY19pZCI6ImZjXzciLCJhcHBseV9saW5rIjp7InRpdGxlIjoiQXBwbHkgb24gTGlua2VkSW4iLCJsaW5rIjoiaHR0cHM6Ly93d3cubGlua2VkaW4uY29tL2pvYnMvdmlldy9iYXJpc3RhLWZ1bGwtdGltZS1hdC1jaGFydHdlbGxzLWhpZ2hlci1lZHVjYXRpb24tZGluaW5nLXNlcnZpY2VzLTI3MTUxNDk3MDk/dXRtX2NhbXBhaWduPWdvb2dsZV9qb2JzX2FwcGx5XHUwMDI2dXRtX3NvdXJjZT1nb29nbGVfam9ic19hcHBseVx1MDAyNnV0bV9tZWRpdW09b3JnYW5pYyJ9fQ=="
    },
    {
      "title": "Barista",
      "company_name": "Starbucks",
      "location": "New York, NY",
      "via": "via LinkedIn",
      "description": "If you are interested in this position, you will need to submit an application through our hiring site:https://starbucks.taleo.net/careersection/jobdetail.ftl?job=210015525&lang=enFrom the beginning, Starbucks set out to be a different kind of company. One that not only celebrated coffee but that also brought a feeling of connection. We are known for developing extraordinary partners who share this passion and are guided by their service to others.Our Baristas personally connect with, laugh with and uplift the lives of our customers. Their work goes beyond handcrafting a perfectly made beverage; it’s about creating a human connection with every customer. They enjoy being able to achieve these aspirations autonomously, while representing a world class brand and the perks that come from being a partner at Starbucks! We have part time and full time opportunities...",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQJPhKaHD4WftuMBB2dJHv8zbLe2QZEkGeQIwxQ7Kc&s",
      "extensions": [
        "22 hours ago",
        "15.77 an hour",
        "Full-time",
        "No degree mentioned"
      ],
      "detected_extensions": {
        "posted_at": "22 hours ago",
        "schedule_type": "Full-time",
        "salary": "15.77 an hour"
      },
      "job_id": "eyJqb2JfdGl0bGUiOiJCYXJpc3RhIiwiaHRpZG9jaWQiOiI5dk1iR0pZS3VCazN0RkN5QUFBQUFBPT0iLCJobCI6ImVuIiwiZmMiOiJFdUlCQ3FJQlFVMXNkbkp3ZFRZdE1XbDRWMWM0YldKMlFuTTJaa1ZIY25BeFJVYzFPVFYwZFd4R2JsSlNWMG90WjFaUFRqSjJjalo0VTNaWFpWTmZja05vZFZaUGJsRnZUV05OYWpKc01qQklZVmQzYkVaVFVrOVFhVFJ6YkhkWE5VWnhZV05vYldsdVQyOXdWRzEwZDNCSVVrZFhjMjFIZGpJdE9GQlJXbGwzTTJwSUxVdGFUVW80VEdOdFIxbDNWRE5RY3pacGFtdE1SMncxVFd0bGJESlJaak5ITldoQkVoY3hYMmhDV1dKcGFrbFBRemR4ZEhOUWJHVlRZMmRCWnhvaVFVaFhVMDV0VjI1WFdIWTBWMEZvWkZkd2FWRkJOa0ZNVmtaeU9UbGhZMTlMVVEiLCJmY3YiOiIzIiwiZmNfaWQiOiJmY18xNSIsImFwcGx5X2xpbmsiOnsidGl0bGUiOiJBcHBseSBvbiBMaW5rZWRJbiIsImxpbmsiOiJodHRwczovL3d3dy5saW5rZWRpbi5jb20vam9icy92aWV3L2JhcmlzdGEtYXQtc3RhcmJ1Y2tzLTI3MTQ1NDk3MTU/dXRtX2NhbXBhaWduPWdvb2dsZV9qb2JzX2FwcGx5XHUwMDI2dXRtX3NvdXJjZT1nb29nbGVfam9ic19hcHBseVx1MDAyNnV0bV9tZWRpdW09b3JnYW5pYyJ9fQ=="
    },
    {
      "title": "Barista",
      "company_name": "Vanilla Gorilla Cafe",
      "location": "New York, NY",
      "via": "via Harri",
      "description": "Seeking a full time or part time Barista.Must be able do basic food prep. Ideal candidate is friendly, and a team player. Must be reliable, loyal and on time to shifts. Doesn’t mind working both morning and afternoon shifts",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRzKuAX5pPRRIPg-pXvqMcFGwpbyufM1UR3GaL6olE&s",
      "extensions": [
        "3 days ago",
        "17 an hour",
        "Full-time",
        "No degree mentioned"
      ],
      "detected_extensions": {
        "posted_at": "3 days ago",
        "schedule_type": "Full-time",
        "salary": "17 an hour"
      },
      "job_id": "eyJqb2JfdGl0bGUiOiJCYXJpc3RhIiwiaHRpZG9jaWQiOiJYU2RKc1FaNWVRbnhjQ3M4QUFBQUFBPT0iLCJobCI6ImVuIiwiYXBwbHlfbGluayI6eyJ0aXRsZSI6IkFwcGx5IG9uIEhhcnJpIiwibGluayI6Imh0dHBzOi8vaGFycmkuY29tL1ZhbmlsbGEtR29yaWxsYS1DYWZlLTIvam9iLzEzMzM5OTQtYmFyaXN0YT91dG1fY2FtcGFpZ249Z29vZ2xlX2pvYnNfYXBwbHlcdTAwMjZ1dG1fc291cmNlPWdvb2dsZV9qb2JzX2FwcGx5XHUwMDI2dXRtX21lZGl1bT1vcmdhbmljIn19"
    ...
  ],
  "chips": [
    {
      "type": "Title",
      "param": "job_family_1",
      "options": [
        {
          "text": "All"
        },
        {
          "text": "Barista",
          "value": "barista"
        },
        {
          "text": "Starbucks barista",
          "value": "starbucks barista"
        },
        ...
      ]
    },
    {
      "type": "Location",
      "param": "city",
      "options": [
        {
          "text": "All"
        }
      ]
    },
    {
      "type": "Date posted",
      "param": "date_posted",
      "options": [
        {
          "text": "All"
        },
        {
          "text": "Past day",
          "value": "today"
        },
        {
          "text": "Past 3 days",
          "value": "3days"
        },
        ...
      ]
    },
    ...
  ]
}