> ## 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, and Upwork. Get the full posting, pay, and requirements for any job as structured JSON.

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

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

<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": "c5bca8f0-bad4-4786-9723-40cb010a6f7e"
}
```

## Endpoints

| Endpoint | Cost |
| - | - |
| [Search Google Jobs: openings from many job sites, with apply links and highlights](/api-reference/endpoint/google-jobs) | 1 credit |
| [Search LinkedIn jobs](/api-reference/endpoint/linkedin-jobs-search) | 1 credit |
| [Get a LinkedIn job's details](/api-reference/endpoint/linkedin-jobs-job) | 1 credit |
| [Search Upwork jobs](/api-reference/endpoint/upwork-search) | 1 credit |
| [Get an Upwork job's details](/api-reference/endpoint/upwork-job) | 1 credit |
| [Search Indeed jobs](/api-reference/endpoint/indeed-search) | 1 credit |
| [Get an Indeed job's details](/api-reference/endpoint/indeed-job) | 1 credit |

## More ways to call it

### Search Indeed jobs

<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>

### Search Upwork jobs

<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 for the full posting.</Tip>


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