Stay organized with collectionsSave and categorize content based on your preferences.
Optionally, a search can include one or moreJobQueryfilters that restrict the search according to different criteria such as
location, companies, compensation, and more.
Location: UselocationFilterto search inside a geographic area.
Job category: Return jobs belonging to a specific category by usingJobCategory.
Categories are predefined and include, for example,ACCOUNTING_AND_FINANCEandEDUCATION. All categories are determined by the Cloud Talent Solution models
and are recommended for use in terms of category-based sorting.
Employment type: Return jobs belonging to one or more employment type
definitions, such asFULL_TIMEorVOLUNTEER. SeeEmploymentTypefor details.
Date range: Restrict the search to jobs published within the specified
date range by usingpublishTimeRange.
Language codes: Returns jobs that match the specified language code, as
determined by the jobs'languageCodesfield. This field specifies the language of the job posting, and has no
relation to any posted language fluency requirements.
Company name: Returns jobs from companies with acompanyDisplayNamestring matching the search query text string. Note thatcompanyDisplayNameis the human-readable name of the company (such as "Google") as opposed tonamewhich is a generated ID (such as
"companies/80df2034-176e-44a8-b763-b5370f2463a5").
Commute: Allows your users to specify a maximum commute time as well as
traffic conditions, time of day, and commute method. Job are returned from
within a calculated area based on these variables. See theCommute Searchimplementation guide for more information.
Compensation: UsecompensationFilterto filter search results based on compensation amounts.
Query language code: Specifies the language of the query string in BCP-47
format, for example "en-US". If left blank, the default is US English. This
field is not related tolanguageCode, which specifies the language of
returned job listings. See theJobQuery documentationfor details. Sample code:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Using search filters\n\nOptionally, a search can include one or more\n[`JobQuery`](/talent-solution/job-search/docs/reference/rest/v4/JobQuery)\nfilters that restrict the search according to different criteria such as\nlocation, companies, compensation, and more.\n\n- **Location** : Use [`locationFilter`](https://cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/JobQuery#locationfilter)\n to search inside a geographic area.\n\n- **Job category** : Return jobs belonging to a specific category by using\n [`JobCategory`](/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.jobs#jobcategory).\n Categories are predefined and include, for example, `ACCOUNTING_AND_FINANCE`\n and `EDUCATION`. All categories are determined by the Cloud Talent Solution models\n and are recommended for use in terms of category-based sorting.\n\n- **Employment type** : Return jobs belonging to one or more employment type\n definitions, such as `FULL_TIME` or `VOLUNTEER`. See\n [`EmploymentType`](/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.jobs#employmenttype)\n for details.\n\n- **Date range** : Restrict the search to jobs published within the specified\n date range by using [`publishTimeRange`](/talent-solution/job-search/docs/reference/rest/v4/JobQuery).\n\n- **Language codes** : Returns jobs that match the specified language code, as\n determined by the jobs' [`languageCodes`](/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.jobs#Job.FIELDS.language_code)\n field. This field specifies the language of the job posting, and has no\n relation to any posted language fluency requirements.\n\n- **Company name** : Returns jobs from companies with a\n [`companyDisplayName`](/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.jobs#Job.FIELDS.companyDisplayName)\n string matching the search query text string. Note that `companyDisplayName`\n is the human-readable name of the company (such as \"Google\") as opposed to\n `name` which is a generated ID (such as\n \"companies/80df2034-176e-44a8-b763-b5370f2463a5\").\n\n- **Commute** : Allows your users to specify a maximum commute time as well as\n traffic conditions, time of day, and commute method. Job are returned from\n within a calculated area based on these variables. See the\n [Commute Search](/talent-solution/job-search/docs/commute-search)\n implementation guide for more information.\n\n- **Compensation** : Use [`compensationFilter`](/talent-solution/job-search/docs/reference/rest/v4/JobQuery#compensationfilter)\n to filter search results based on compensation amounts.\n\n- **Query language code** : Specifies the language of the query string in BCP-47\n format, for example \"en-US\". If left blank, the default is US English. This\n field is not related to `languageCode`, which specifies the language of\n returned job listings. See the\n [JobQuery documentation](https://cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/JobQuery)\n for details. Sample code:\n\n \"jobQuery\":\n {\"query\":\"general\", \"query_language_code\":\"fr-FR\"}}"]]