Google Jobs

Perform Search

Overview

Method	Endpoint	Version	Description
`POST`	`/api/v1/open/search`	v1	Google Search API endpoint for retrieving search results

Request Headers

Header	Type	Required	Description
`Content-Type`	`string`	Yes	Must be set to `application/json`
`Accept`	`string`	No	Response format (defaults to `application/json`)

Authentication

API Key Authentication - Pass the API key as a request parameter: api_key=your_api_key - Example: "api_key": "your_api_key_here"

Request Example

curl -X POST "https://domain/api/v1/open/search" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your_api_key_here",
    // ...
  }'

Response Format

All responses follow a standardized JSON structure:

{
  "code": 200,
  "msg": "Success",
  "reqId": "req_1234567890",
  "timestamp": "2025-01-08T10:30:00Z",
  "data": {
    // Response data object
  }
}

HTTP Status Codes

Code	Status	Description	Retry
200	OK	Request successful	No

Request Parameters

Parameter	Type	Required	Description	Default
`api_key`	`string`	Yes	API key for authentication
`engine`	`string`	Yes	Search engine type, currently engine value is `google_jobs`	google
`q`	`string`	Yes	Search query, supports regular Google search syntax (like inurl:, site:, intitle:) and advanced search parameters
`google_domain`	`string`	No	Google domain, defaults to google.com	google.com
`gl`	`string`	No	Search country code (e.g., us-United States, uk-United Kingdom, fr-France). Head to the Google countries page for a full list of supported Google countries.
`hl`	`string`	No	Search language code (e.g., en-English, es-Spanish, fr-French). Head to the Google languages page for a full list of supported Google languages.
`chips`	`string`	No	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. This parameter has been deprecated by Google	desktop
`lrad`	`string`	No	Defines search radius in kilometers. Does not strictly limit the radius
`uds`	`string`	No	Parameter enables to filter search. It's a string provided by Google as a filter. uds values are provided under the section: filters with uds, q and serpapi_link values provided for each filter
`ltype`	`string`	No	Parameter will filter the results by work from home. This parameter has been deprecated by Google	0
`html`	`string`	No	Whether to return HTML format, 1-yes, 0-no	0

Response Example

{
    "code": 200,
    "data": {
        "search_metadata": {
            "raw_html_file": "oss_html",
            "total_time_taken": 2.032416469,
            "id": "1985902431212408832",
            "json_endpoint": "oss_json",
            "created_at": "2025-10-29 08:53:31",
            "processed_at": "2025-10-29 08:53:33",
            "google_url": "https://www.google.com/search?q=coffee&udm=8",
            "status": "Success"
        },
        "search_information": {
          "organic_results_state": "Showing results for exact spelling despite spelling suggestion",
          "time_taken_displayed": 0.033
        },
        "search_parameters": {
            "engine": "google_jobs",
            "html": "0",
            "google_domain": "www.google.com",
            "q": "coffee", 
            "udm": 8
        },
        "organic_results": [
            {
                "position": 1,
                "title": "AI Engineer - Now Hiring",
                "company_name": "MassMutual",
                "location": "New York, NY",
                "via": "Snagajob",
                "share_link": "https://www.google.com/search?",
                "thumbnail": [
                    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADgAAAAcCAMAAAAADZYWAAAA"
                ],
                "extensions": [
                    "2 days ago",
                    "Full-time and Part-time"
                ],
                "detected_extensions": {
                    "posted_at": "2 days ago",
                    "schedule_type": "Full-time and Part-time",
                    "salary": "250K–350K a year"
                },
                "description": "Overall Responsibilities:\n· Architect and lead end-to-",
                "apply_options": [
                    {
                        "title": "Snagajob",
                        "link": "https://www.snagajob.com/jobs/1175117237?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic"
                    }
                ],
                "job_highlights": [
                    {
                        "title": "Qualifications",
                        "items": [
                            "Recognized industry expertise in AI/ML, with a track record of delivering impactful solu"
                        ]
                    }
                ]
            }
        ]
    },
    "msg": "string",
    "reqId": "string"
}

Complete Response Parameters Overview

search_metadata

object Contains metadata about the search execution

Parameter	Type	Description	Applicable Terminal
`id`	`string`	Unique identifier for the search request	desktop
`json_endpoint`	`string`	Provide an interface endpoint for searching related JSON data, through which JSON-formatted search data can be obtained	desktop
`created_at`	`string`	The timestamp when the search request was created, recording the time when the search was initiated	desktop
`processed_at`	`string`	The timestamp when the search results were processed and became available for return, recording the time point from processing to completion of the search	desktop
`google_url`	`string`	The Google search URL, which contains the search keyword "coffee" along with language parameters (hl=en for English), regional parameters (gl=us for the United States), and other search parameters, used to redirect to the corresponding Google search page	desktop
`status`	`string`	Status of the search execution (e.g., Success)	desktop
`raw_html_file`	`string`	Identifier for the original HTML file	desktop
`total_time_taken`	`number`	The total time spent on the entire search process (including request sending, result parsing, and other stages)	desktop

search_information

object Contains information about the search results

Parameter	Type	Description	Applicable Terminal
`organic_results_state`	`string`	State of organic results	desktop
`time_taken_displayed`	`number`	TDisplay time (i.e., the time spent on displaying the search results)	desktop

search_parameters

object Contains the parameters used for the search

Parameter	Type	Description	Applicable Terminal
`q`	`string`	Keywords used for this query	desktop
`engine`	`string`	Search engine used for this query (e.g., google_web)	desktop
`html`	`string`	When HTML=0, returns JSON; when HTML=1, returns HTML; when HTML=2, returns both JSON and HTML	desktop
`device`	`string`	Device type used during search (e.g., desktop)	desktop
`google_domain`	`string`	Specifies the corresponding Google domain (e.g., google.com, etc., used to distinguish Google services in different regions/locales)	desktop
`udm`	`number`	8	desktop

organic_results

object[] Job/position results (including recruitment postings and workplace-related content)

Parameter	Type	Description	Applicable Terminal
`position`	`number`	The ranking of this position in organic job search results	desktop
`title`	`string`	Job title (displaying position name)	desktop
`company_name`	`string`	Company name of the hiring employer	desktop
`location`	`string`	Work location	desktop
`via`	`string`	Job posting source platform	desktop
`share_link`	`string`	Job position shareable link	desktop
`thumbnail`	`string[]`	Job-related thumbnail list, elements being Base64-encoded image strings (typically including company logos, etc.)	desktop
`extensions`	`string[]`	Job additional information list	desktop
`detected_extensions`	`object`	Split additional information into specific subfields	desktop
`detected_extensions.posted_at`	`string`	Job posting time	desktop
`detected_extensions.schedule_type`	`string`	Work schedule type (e.g. Full-time)	desktop
`detected_extensions.salary`	`string`	Salary range‌ / ‌Salary description	desktop
`description`	`string`	Job description fragment displaying core information such as responsibilities	desktop
`apply_options`	`object[]`	Job application channels list	desktop
`apply_options[].title`	`string`	‌Application channel name	desktop
`apply_options[].link`	`string`	Job application specific link	desktop
`job_highlights`	`object[]`	‌Job highlights / key information list	desktop
`job_highlights[].title`	`string`	‌Category title for highlight information‌ (e.g. Qualifications)	desktop
`job_highlights[].items`	`string[]`	Category item list	desktop