Google jobs API

Search Google Jobs: openings from many job sites, with apply links and highlights

curl --request POST \
  --url https://api.stophy.dev/v1/google/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "software engineer",
  "location": "Austin, TX"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: 'software engineer', location: 'Austin, TX'})
};

fetch('https://api.stophy.dev/v1/google/jobs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/google/jobs"

payload = {
    "query": "software engineer",
    "location": "Austin, TX"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "results": [
      {
        "jobId": "<string>",
        "title": "<string>",
        "jobUrl": "<string>",
        "position": 123,
        "companyName": "<string>",
        "location": "<string>",
        "via": "<string>",
        "publishedAt": "2023-11-07T05:31:56Z",
        "jobType": "<string>",
        "salary": "<string>",
        "benefits": [
          "<string>"
        ],
        "apply": [
          {
            "site": "<string>",
            "url": "<string>"
          }
        ],
        "qualifications": [
          "<string>"
        ],
        "responsibilities": [
          "<string>"
        ],
        "description": "<string>"
      }
    ],
    "cursor": "<string>"
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

POST

google

jobs

Search Google Jobs: openings from many job sites, with apply links and highlights

curl --request POST \
  --url https://api.stophy.dev/v1/google/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "software engineer",
  "location": "Austin, TX"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: 'software engineer', location: 'Austin, TX'})
};

fetch('https://api.stophy.dev/v1/google/jobs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/google/jobs"

payload = {
    "query": "software engineer",
    "location": "Austin, TX"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "results": [
      {
        "jobId": "<string>",
        "title": "<string>",
        "jobUrl": "<string>",
        "position": 123,
        "companyName": "<string>",
        "location": "<string>",
        "via": "<string>",
        "publishedAt": "2023-11-07T05:31:56Z",
        "jobType": "<string>",
        "salary": "<string>",
        "benefits": [
          "<string>"
        ],
        "apply": [
          {
            "site": "<string>",
            "url": "<string>"
          }
        ],
        "qualifications": [
          "<string>"
        ],
        "responsibilities": [
          "<string>"
        ],
        "description": "<string>"
      }
    ],
    "cursor": "<string>"
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

Searches Google Jobs: openings from many job sites, with apply links and highlights.

Request

query is required.

import { Stophy } from "stophy";

const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.google.jobs({ query: "software engineer", location: "Austin, TX" });
console.log(result.data.results);

from stophy import Stophy

stophy = Stophy()  # reads STOPHY_API_KEY
result = stophy.google.jobs(query="software engineer", location="Austin, TX")
print(result["data"]["results"])

curl -X POST https://api.stophy.dev/v1/google/jobs \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"software engineer","location":"Austin, TX"}'

stophy google jobs "software engineer" --location "Austin, TX"

Response

If successful, the response body contains the standard envelope. data.results[] contains the openings, each with its company, location and links to apply. The following example is illustrative.

{
  "success": true,
  "data": {
    "results": [
      {
        "jobId": "eyJqb2JfdGl0bGUiOiJTb2Z0d2FyZSBFbmdpbmVlciJ9",
        "title": "Software Engineer",
        "companyName": "Example Corp",
        "location": "Austin, TX",
        "via": "Example Jobs",
        "publishedAt": "2026-10-01T00:00:00.000Z",
        "jobType": "Full-time",
        "salary": "140K–170K a year",
        "benefits": ["Health insurance", "Paid time off"],
        "apply": [
          {
            "site": "Example Jobs",
            "url": "https://jobs.example.com/software-engineer"
          }
        ],
        "qualifications": ["3 years of experience"],
        "responsibilities": ["Build and ship features"],
        "description": "Build and run the services behind our product.",
        "jobUrl": "https://www.google.com/search?q=software+engineer&ibp=htl;jobs",
        "position": 1
      }
    ],
    "cursor": "CgJUWBIFSm9icxo"
  },
  "creditsUsed": 1,
  "requestId": "2fe9dbad-fc48-4890-9751-0b24b596035b"
}

Field	Type	Description
`cursor`	string	The pagination token. Pass it as `cursor` to retrieve the next page. Omitted on the last page.
`via`	string	The site Google found the post on.
`salary`	string	As Google shows it, such as 140K–170K a year.
`publishedAt`	string (ISO 8601)	Approximate. Google shows how long ago.
`position`	integer	The 1-based position of the result in the list.

For every field, see the response schema on this page.

Optional parameters

Parameter	Type	Description
`location`	string	City or area, such as Austin, TX.
`country`	string	The country to query, as a two-letter ISO 3166-1 code such as `us`. If unset, defaults to `us`.
`language`	string	The language of the results, as a BCP 47 tag such as `en` or `pt-BR`. If unset, defaults to `en`.
`datePosted`	string	Restricts results to jobs posted in this period. Acceptable values are `yesterday`, `last3Days`, `lastWeek` and `lastMonth`.
`jobType`	string	Restricts results to this type of job. Acceptable values are `fullTime`, `partTime`, `contract` and `internship`.
`remote`	boolean	Restricts results to remote jobs. If unset, defaults to `false`.
`noDegree`	boolean	Restricts results to jobs that need no degree. If unset, defaults to `false`.
`cursor`	string	The pagination token from the previous response.

Billing

Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.

Pagination

Results are paginated. To retrieve the next page, pass the value of data.cursor as cursor in a subsequent request. A response that omits cursor is the last page.

LinkedIn jobs search: Accepts a job’s title as query, with its location,. Searches LinkedIn jobs.
Indeed search: Accepts a job’s title as query, with its location,. Searches Indeed jobs.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

query

string

required

The role, like software engineer.

Required string length: 1 - 400

location

string

City or area, like Austin, TX.

Required string length: 2 - 100

country

string

default:us

ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted.

Pattern: ^[A-Za-z]{2}$

language

string

default:en

BCP 47 language tag, e.g. en or pt-BR. Any case is accepted.

Pattern: ^[A-Za-z]{2,3}(?:[-_][A-Za-z0-9]{2,4})?$

datePosted

enum<string>

Google Jobs' own Date posted.

Available options:

yesterday,

last3Days,

lastWeek,

lastMonth

jobType

enum<string>

Google Jobs' own Job type.

Available options:

fullTime,

partTime,

contract,

internship

remote

boolean

default:false

Google Jobs' own Remote chip.

noDegree

boolean

default:false

Google Jobs' own No degree chip.

cursor

string

The cursor from the previous response. Send it as is.

Minimum string length: 1

Response

The data, and the credits this call used.

success

any

required

data

object

required

Show child attributes

creditsUsed

integer

required

requestId

string

required

Using the API

Catalog

Account

Search and AI answers

Video

Social

Places and travel

Jobs

Shopping

Apps

Real estate

Ads

Google jobs API

Request

Response

Optional parameters

Billing

Authorizations

Body

Response

​Request

​Response

​Optional parameters

​Billing

​Pagination

​Related methods

Authorizations

Body

Response

Request

Response

Optional parameters

Billing

Pagination

Related methods