# Google Jobs API

> Search job listings aggregated by Google Jobs with title, company, location, posting date, salary and apply links, filtered by location and language.

Source: https://www.sandbase.ai/apis/google/jobs
API reference: https://www.sandbase.ai/apis/google/jobs#api

## Facts

- Provider: Google
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/google/jobs`
- Price: $0.01 per call
- Capabilities: api, google, jobs, serp
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/google/jobs` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `q` | string | yes |  |
| `location` | string | no |  |
| `uule` | string | no |  |
| `google_domain` | string | no |  |
| `gl` | string | no |  |
| `hl` | string | no |  |
| `next_page_token` | string | no |  |
| `chips` | string | no |  |
| `lrad` | string | no |  |
| `ltype` | string | no |  |
| `uds` | string | no |  |
| `json_restrictor` | string | no |  |

## FAQ

### How do I use the Google Jobs API?

Send a POST request to https://api.sandbase.ai/v1/api/google/jobs with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Google Jobs API cost?

$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Google Jobs API accept?

Required: q (string). Optional: location (string), uule (string), google_domain (string), gl (string), hl (string) and next_page_token (string) and 5 more. The Parameters table and the Playground on this page list every field.

### What does the Google Jobs API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Google developer account or API key?

No. Google Jobs runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Google API access separately.

## README

### Google Jobs

Search job listings aggregated by Google Jobs with title, company, location, posting date, salary and apply links, filtered by location and language.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/google/jobs" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "data engineer", "location": "Austin, Texas, United States"}'
```

The result is returned in `outputs[0].data` as structured JSON.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `q` | string | Yes | Parameter defines the query you want to search. |
| `location` | string | No | Parameter defines from where you want the search to originate. If several locations match the location requested, we'll pick the most popular one. Head to the /locations.json API if you need more precise control. The `location` and `uule` p |
| `uule` | string | No | Parameter is the Google encoded location you want to use for the search. `uule` and `location` parameters can't be used together. For consistent results with coordinates-based `uule` parameter, a matching `gl` parameter is required. Head to |
| `google_domain` | string | No | Parameter defines the Google domain to use. It defaults to `google.com`. Head to the Google domains page for a full list of supported Google domains. |
| `gl` | string | No | Parameter defines the country to use for the Google Jobs search. It's a two-letter country code. (e.g., `us` for the United States, `uk` for United Kingdom, or `fr` for France) Head to the Google Jobs countries page for a full list of suppo |
| `hl` | string | No | Parameter defines the language to use for the Google Jobs search. It's a two or three-letter language code. (e.g., `en` for English, `es` for Spanish, or `fr` for French), optionally followed by a two-letter or three-digit region code (e.g. |
| `next_page_token` | string | No | Parameter defines the next page token. It is used for retrieving the next page of results. Up to `10` results are returned per page. The next page token can be found in the the API JSON response: `the API_pagination -> next_page_token` Usag |
| `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 |
| `lrad` | string | No | Defines search radius in kilometers. Does not strictly limit the radius. |
| `ltype` | string | No | Parameter will filter the results by work from home. This parameter has been deprecated by Google. |
| `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 `the API_link` values provided for each filter. |
| `json_restrictor` | string | No | Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details. |

#### Pricing

$0.010 per successful call. Failed calls are not charged.