> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stophy.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Jobs

> Search job listings on Google Jobs, LinkedIn, Indeed, Upwork and company careers pages. Get the full posting, pay and requirements for any job.

Search job listings on Google Jobs, LinkedIn, Indeed, Upwork and company careers pages. Get the full posting, pay and requirements for any job. See every field in the [Jobs reference](/api-reference/endpoint/google-jobs), or try it in the [playground](https://stophy.dev/playground).

## Scrape Google Jobs results

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  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);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

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

  ```bash cURL icon="terminal" theme={null}
  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"}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy google jobs "software engineer" --location "Austin, TX"
  ```
</CodeGroup>

The response:

```json theme={null}
{
  "success": true,
  "data": {
    "results": [
      {
        "jobId": "abc123",
        "title": "Example title",
        "companyName": "example",
        "location": "example",
        "via": "example",
        "publishedAt": "2026-09-28T12:00:00.000Z",
        "jobType": "example",
        "salary": "example",
        "benefits": [
          "example"
        ],
        "apply": [
          {
            "site": "example",
            "url": "https://example.com/"
          }
        ],
        "qualifications": [
          "example"
        ],
        "responsibilities": [
          "example"
        ],
        "description": "A short, readable summary of the result.",
        "jobUrl": "https://example.com/",
        "position": 1
      }
    ]
  },
  "creditsUsed": 1,
  "requestId": "ec5d037c-33e3-4ee3-8bf4-9c7bea77c828"
}
```

## Endpoints

| Endpoint | Cost |
| - | - |
| [Scrape Google Jobs results](/api-reference/endpoint/google-jobs) | 1 credit |
| [Scrape LinkedIn job search results](/api-reference/endpoint/linkedin-jobs-search) | 1 credit |
| [Scrape a LinkedIn job page](/api-reference/endpoint/linkedin-jobs-job) | 1 credit |
| [Scrape Upwork job search results](/api-reference/endpoint/upwork-search) | 1 credit |
| [Scrape an Upwork job page](/api-reference/endpoint/upwork-job) | 1 credit |
| [Scrape Indeed job search results](/api-reference/endpoint/indeed-search) | 1 credit |
| [Scrape an Indeed job page](/api-reference/endpoint/indeed-job) | 1 credit |
| [Scrape a company's open jobs from its careers page](/api-reference/endpoint/careers-jobs) | 1 credit |
| [Scrape one job from a company's careers page](/api-reference/endpoint/careers-job) | 1 credit |

## More ways to call it

### Scrape Indeed job search results

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.indeed.search({ query: "data analyst", location: "Chicago, IL", datePosted: "last7Days" });
  console.log(result.data.results);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.indeed.search(query="data analyst", location="Chicago, IL", date_posted="last7Days")
  print(result["data"]["results"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/indeed/search \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"query":"data analyst","location":"Chicago, IL","datePosted":"last7Days"}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy indeed search "data analyst" --location "Chicago, IL" --datePosted last7Days
  ```
</CodeGroup>

### Scrape Upwork job search results

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.upwork.search({ query: "react developer" });
  console.log(result.data.results);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.upwork.search(query="react developer")
  print(result["data"]["results"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/upwork/search \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"query":"react developer"}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy upwork search "react developer"
  ```
</CodeGroup>

<Tip>Pass the job link from a search result into that site's job endpoint to get the full posting.</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.