Stay organized with collections
Save and categorize content based on your preferences.
Optionally, a search can include one or more
JobQuery
filters that restrict the search according to different criteria such as
location, companies, compensation, and more.
Location: Use locationFilter
to search inside a geographic area.
Job category: Return jobs belonging to a specific category by using
JobCategory.
Categories are predefined and include, for example, ACCOUNTING_AND_FINANCE
and EDUCATION. 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 as FULL_TIME or VOLUNTEER. See
EmploymentType
for details.
Date range: Restrict the search to jobs published within the specified
date range by using publishTimeRange.
Language codes: Returns jobs that match the specified language code, as
determined by the jobs' languageCodes
field. 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 a
companyDisplayName
string matching the search query text string. Note that companyDisplayName
is the human-readable name of the company (such as "Google") as opposed to
name which 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 the
Commute Search
implementation guide for more information.
Compensation: Use compensationFilter
to 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 to languageCode, which specifies the language of
returned job listings. See the
JobQuery documentation
for 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-08-28 UTC."],[],[],null,["# Using search filters (v4beta1)\n\nOptionally, a search can include one or more\n[`JobQuery`](/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/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/v4beta1/docs/reference/rest/v4beta1/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/v4beta1/docs/reference/rest/v4beta1/projects.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/v4beta1/docs/reference/rest/v4beta1/projects.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/v4beta1/docs/reference/rest/v4beta1/JobQuery).\n\n- **Language codes** : Returns jobs that match the specified language code, as\n determined by the jobs' [`languageCodes`](/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.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/v4beta1/docs/reference/rest/v4beta1/projects.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/v4beta1/docs/commute-search)\n implementation guide for more information.\n\n- **Compensation** : Use [`compensationFilter`](/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/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/v4beta1/docs/reference/rest/v4beta1/JobQuery)\n for details. Sample code:\n\n \"jobQuery\":\n {\"query\":\"general\", \"query_language_code\":\"fr-FR\"}}"]]
