How to get SERP data from Google Jobs?
Using our new Google Jobs endpoint, you can receive SERP results from the Google Jobs search engine. It will provide you with job listings for the specified keyword, language, and location. Along with each listing, you will receive job ID, job title, employer info, salary info, date and time when the job vacancy was posted, and other relevant data.
How to use the Google Jobs endpoint
1 Call the endpoint.
POST https://api.dataforseo.com/v3/serp/google/jobs/task_post
2 Specify the keyword for which you wish to receive job listings in the keyword field. Note that the keyword you specify must indicate the existing job title.
Example: "keyword": ".net developer"
3 Specify the location for which you want the API to return job listings by adding the location_name or location_code field to the POST body.
You will receive the full list of supported locations by making a separate request to the Locations endpoint.
GET https://api.dataforseo.com/v3/serp/google/locations
4 Specify the language for which you want the API to return job listings by adding the language_name or language_code field to the POST body.
You will receive the full list of supported languages by making a separate request to the Languages endpoint.
GET https://api.dataforseo.com/v3/serp/google/languages
5 Specify the number of job listings to be returned in the API response. To do that, add the depth parameter and set it to the desired value.
Default depth value: 10.
Maximum depth value: 200
We strongly recommend setting the depth in the multiples of ten as our system processes ten results in a row. Thus, if you specify "depth": 11, our API will return 20 results, and you will be charged for 20 results.
Specifying the parameters above is enough to make a request. However, if you wish to receive more specific results, you can use additional POST request parameters:
• employment_type — by using this field, you can indicate for which type of employment contract to return SERP results. Possible values: fulltime, partime, contractor, intern.
• date_posted — by using this field, you can filter job vacancies by posting date. Possible values: today — return job vacancies posted today, 3days — return job vacancies posted no longer than 3 days ago, week — return job vacancies posted no longer than a week ago, month — return job vacancies posted no longer than a month ago.
Your POST request should be structured as in the following example:
[
{
"keyword": ".net deveper",
"language_code": "en",
"location_code": 2840,
"depth": 10,
"employment_type": ["contractor","fulltime"],
"date_posted": "month"
}
]
6 Send a request and copy the Task ID from the response.
7 Call the Google Jobs Task GET Advanced endpoint and use the copied ID to retrieve the results.
GET https://api.dataforseo.com/v3/serp/google/jobs/task_get/advanced/$id
Example of the API response:
{
"version": "0.1.20220428",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.1598 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "06091150-2806-0447-0000-7beb9e5146cb",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0183 sec.",
"cost": 0,
"result_count": 1,
"path": [
"v3",
"serp",
"google",
"jobs",
"task_get",
"advanced",
"06091150-2806-0447-0000-7beb9e5146cb"
],
"data": {
"api": "serp",
"function": "task_get",
"se": "google",
"se_type": "jobs",
"keyword": ".net deveper",
"language_code": "en",
"location_code": 2840,
"depth": 10,
"employment_type": [
"contractor",
"fulltime"
],
"date_posted": "month",
"device": "desktop",
"os": "windows"
},
"result": [
{
"keyword": ".net deveper",
"type": "jobs",
"se_domain": "google.com",
"location_code": 2840,
"language_code": "en",
"check_url": "https://google.com/search?q=.net%20deveper&ibp=htl;jobs&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc#htivrt=jobs&fpstate=tldetail&htichips=employment_type:CONTRACTOR,employment_type:FULLTIME,date_posted:month&htischips=employment_type;CONTRACTOR;FULLTIME,date_posted;month&htilrad=4.0",
"datetime": "2022-06-09 08:50:39 +00:00",
"spell": null,
"item_types": [
"google_jobs_item"
],
"se_results_count": 0,
"items_count": 10,
"items": [
{
"type": "google_jobs_item",
"rank_group": 1,
"rank_absolute": 1,
"position": "right",
"xpath": "/html[1]/body[1]/div[3]/div[1]/div[2]/div[1]/div[1]/div[1]/div[3]/div[1]/div[1]/div[4]/div[1]/div[1]/ul[1]/li[1]",
"job_id": "VwWDit-y3VQAAAAAAAAAAA==",
"title": "C# .NET Developer",
"employer_name": "Dice",
"employer_url": null,
"employer_image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQKlgydP7sElaJC9qPrtNHwBhyTMHYgii1RPWsy&s=0",
"location": "United States",
"source_name": "via LinkedIn",
"source_url": "https://www.linkedin.com/jobs/view/c%23-net-developer-at-dice-3116757669?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
"salary": null,
"contract_type": "Contractor",
"timestamp": "2022-06-08 11:50:39 +00:00",
"time_ago": "21 hours ago",
"rectangle": null
},
{
"type": "google_jobs_item",
"rank_group": 2,
"rank_absolute": 2,
"position": "right",
"xpath": "/html[1]/body[1]/div[3]/div[1]/div[2]/div[1]/div[1]/div[1]/div[3]/div[1]/div[1]/div[4]/div[1]/div[1]/ul[1]/li[2]",
"job_id": "NmmpLYkClaoAAAAAAAAAAA==",
"title": ".NET developer Umbraco experience preferred",
"employer_name": "Upwork",
"employer_url": "http://www.elance.com/",
"employer_image_url": null,
"location": "United States",
"source_name": "via Upwork",
"source_url": "https://www.upwork.com/freelance-jobs/apply/NET-developer-Umbraco-experience-preferred_~01205df29f4fe6c8fa/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
"salary": null,
"contract_type": "Contractor",
"timestamp": "2022-06-08 21:50:39 +00:00",
"time_ago": "11 hours ago",
"rectangle": null
},
{
"type": "google_jobs_item",
"rank_group": 3,
"rank_absolute": 3,
"position": "right",
"xpath": "/html[1]/body[1]/div[3]/div[1]/div[2]/div[1]/div[1]/div[1]/div[3]/div[1]/div[1]/div[4]/div[1]/div[1]/ul[1]/li[3]",
"job_id": "Q3O_nBcSJm8AAAAAAAAAAA==",
"title": ".Net Developer - Backend Focused",
"employer_name": "Dice",
"employer_url": null,
"employer_image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQKlgydP7sElaJC9qPrtNHwBhyTMHYgii1RPWsy&s=0",
"location": "United States",
"source_name": "via LinkedIn",
"source_url": "https://www.linkedin.com/jobs/view/net-developer-backend-focused-at-dice-3115659983?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
"salary": null,
"contract_type": "Full–time",
"timestamp": "2022-06-09 00:50:39 +00:00",
"time_ago": "8 hours ago",
"rectangle": null
},
{
"type": "google_jobs_item",
"rank_group": 4,
"rank_absolute": 4,
"position": "right",
"xpath": "/html[1]/body[1]/div[3]/div[1]/div[2]/div[1]/div[1]/div[1]/div[3]/div[1]/div[1]/div[4]/div[1]/div[1]/ul[1]/li[4]",
"job_id": "uvdrdbE0WI8AAAAAAAAAAA==",
"title": "Senior .Net Developer- REMOTE ROLE",
"employer_name": "CorroHealth",
"employer_url": "http://corrohealth.com/",
"employer_image_url": null,
"location": "United States",
"source_name": "via CorroHealth Careers",
"source_url": "https://careers.corrohealth.com/united-states/jobs/2058?lang=en-us&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
"salary": null,
"contract_type": "Full–time",
"timestamp": "2022-06-07 08:50:39 +00:00",
"time_ago": "2 days ago",
"rectangle": null
},
{
"type": "google_jobs_item",
"rank_group": 5,
"rank_absolute": 5,
"position": "right",
"xpath": "/html[1]/body[1]/div[3]/div[1]/div[2]/div[1]/div[1]/div[1]/div[3]/div[1]/div[1]/div[4]/div[1]/div[1]/ul[1]/li[5]",
"job_id": "ptF8_bc8t2AAAAAAAAAAAA==",
"title": "Microsoft .NET Developer(Remote)",
"employer_name": "Dice",
"employer_url": null,
"employer_image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQKlgydP7sElaJC9qPrtNHwBhyTMHYgii1RPWsy&s=0",
"location": "United States",
"source_name": "via LinkedIn",
"source_url": "https://www.linkedin.com/jobs/view/microsoft-net-developer-remote-at-dice-3115664275?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
"salary": null,
"contract_type": "Contractor",
"timestamp": "2022-06-08 08:50:39 +00:00",
"time_ago": "1 day ago",
"rectangle": null
},
{
"type": "google_jobs_item",
"rank_group": 6,
"rank_absolute": 6,
"position": "right",
"xpath": "/html[1]/body[1]/div[3]/div[1]/div[2]/div[1]/div[1]/div[1]/div[3]/div[1]/div[1]/div[4]/div[1]/div[1]/ul[1]/li[6]",
"job_id": "JxR_7VhKA48AAAAAAAAAAA==",
"title": "Sr .NET Developer",
"employer_name": "Perficient, Inc.",
"employer_url": "http://www.perficient.com/",
"employer_image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSyoUxyXjS1y0e2C9n9vlqlXB85PB6lyGfEJxHc&s=0",
"location": "United States",
"source_name": "via Mendeley",
"source_url": "https://www.mendeley.com/careers/job/sr-net-developer-13721868?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
"salary": null,
"contract_type": "Full–time",
"timestamp": "2022-06-08 08:50:39 +00:00",
"time_ago": "1 day ago",
"rectangle": null
},
{
"type": "google_jobs_item",
"rank_group": 7,
"rank_absolute": 7,
"position": "right",
"xpath": "/html[1]/body[1]/div[3]/div[1]/div[2]/div[1]/div[1]/div[1]/div[3]/div[1]/div[1]/div[4]/div[1]/div[1]/ul[1]/li[7]",
"job_id": "DfhOEnE2FFkAAAAAAAAAAA==",
"title": ".NET Developer (SR/SSR)",
"employer_name": "Upwork",
"employer_url": "http://www.elance.com/",
"employer_image_url": null,
"location": "United States",
"source_name": "via Upwork",
"source_url": "https://www.upwork.com/freelance-jobs/apply/NET-Developer-SSR_~015f52b11d62a99be1/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
"salary": null,
"contract_type": "Contractor",
"timestamp": "2022-06-08 08:50:39 +00:00",
"time_ago": "1 day ago",
"rectangle": null
},
{
"type": "google_jobs_item",
"rank_group": 8,
"rank_absolute": 8,
"position": "right",
"xpath": "/html[1]/body[1]/div[3]/div[1]/div[2]/div[1]/div[1]/div[1]/div[3]/div[1]/div[1]/div[4]/div[1]/div[1]/ul[1]/li[8]",
"job_id": "yTqb6WLlNZUAAAAAAAAAAA==",
"title": ".Net Developer",
"employer_name": "NLB Services",
"employer_url": "http://www.nlbservices.com/",
"employer_image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRJqUcgqnltMRxCtf5IUZzbKN6ZTko2GO_QKcuY&s=0",
"location": "United States",
"source_name": "via LinkedIn",
"source_url": "https://www.linkedin.com/jobs/view/net-developer-at-nlb-services-3116786430?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
"salary": null,
"contract_type": "Contractor",
"timestamp": "2022-06-08 13:50:39 +00:00",
"time_ago": "19 hours ago",
"rectangle": null
},
{
"type": "google_jobs_item",
"rank_group": 9,
"rank_absolute": 9,
"position": "right",
"xpath": "/html[1]/body[1]/div[3]/div[1]/div[2]/div[1]/div[1]/div[1]/div[3]/div[1]/div[1]/div[4]/div[1]/div[1]/ul[1]/li[9]",
"job_id": "5f4u-lfgoHoAAAAAAAAAAA==",
"title": ".Net Developer",
"employer_name": "Enterprise Solutions Inc.",
"employer_url": null,
"employer_image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQZ8kX8mrrHKmaZ9hsAoXrOYGbfUh5vxqx1l-Br&s=0",
"location": "United States",
"source_name": "via LinkedIn",
"source_url": "https://www.linkedin.com/jobs/view/net-developer-at-enterprise-solutions-inc-3116206437?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
"salary": null,
"contract_type": "Full–time",
"timestamp": "2022-06-08 18:50:39 +00:00",
"time_ago": "14 hours ago",
"rectangle": null
},
{
"type": "google_jobs_item",
"rank_group": 10,
"rank_absolute": 10,
"position": "right",
"xpath": "/html[1]/body[1]/div[3]/div[1]/div[2]/div[1]/div[1]/div[1]/div[3]/div[1]/div[1]/div[4]/div[1]/div[1]/ul[1]/li[10]",
"job_id": "o5nqgP5u7qoAAAAAAAAAAA==",
"title": ".net Developer",
"employer_name": "KYLMAR Solutions",
"employer_url": null,
"employer_image_url": null,
"location": "United States",
"source_name": "via Adzuna",
"source_url": "https://www.adzuna.com/details/3203879385?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
"salary": null,
"contract_type": "Full–time",
"timestamp": "2022-06-06 08:50:39 +00:00",
"time_ago": "3 days ago",
"rectangle": null
}
]
}
]
}
]
}