Google Jobs API: Overview
Google Jobs API provides search results based on the Google Jobs search engine.
The returned results are specific to the indicated keyword, language and location parameters. We emulate set location with the highest accuracy so that the results you receive will match the actual search results for the specified parameters at the time of task setting. You can always check the returned results by accessing the check_url in the Incognito mode to make sure the received data is entirely relevant. Note that user preferences, search history, and other personalized search factors are ignored by our system and thus would not be reflected in the returned SERP results.
Google Jobs API makes use of rank_group and rank_absolute parameters that show search engine result’s position among the group of elements or across all the elements in SERP respectively. Learn more about the difference between rank absolute and rank group in our help article.
Google Jobs API functions
Google Jobs API provides search engine results with two standard functions: Advanced and HTML.
The Advanced function provides up to 200 search results for the specified keyword, language, and location.
The HTML function provides a raw SERP HTML page for the specified keyword, language, and location.
Methods
Google Jobs API supports the standard method of data retrieval. This method requires making separate POST and GET requests. Using this method, you can retrieve the results after our system collects them.
Alternatively, you can specify pingback_url or postback_url when setting a task, and we will notify you on completion of tasks or send the results to you respectively. Note that if you use the postback_url field, you should also indicate the function that will be applied for data retrieval: regular or html.
If you need to set several tasks, you can receive the list of id for all completed tasks using ‘Tasks Ready’ endpoint, and then collect the results of each separate task using ‘Task GET’ endpoint.
Learn more about task completion and obtaining a list of completed tasks in this help center article.
You can send up to 2000 POST and GET API calls per minute in total, with each POST call containing no more than 100 tasks. Contact us if you would like to raise the limit.
Cost
The Live method delivers results in real-time, and accordingly, the cost of requests made using this method will be the highest.
The Standard method has two different priorities that stand for the relative speed of task execution and have different prices:
1. Normal priority;
2. High priority.
Note: setting depth above the default value will increase the cost of the task. For example, if the default value is 10, you will be billed for every 10 results. So, if you specify "depth": 15, the price for the task will be multiplied by 2 and you will be billed as for 20 results.
The cost can be calculated on the Pricing page. To learn more about the cost of all SERP API methods, priorities, and additional parameters, please refer to this help article.
You can test Google Jobs API for free using DataForSEO Sandbox.