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

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

## Search LinkedIn 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.linkedin.jobs.search({ query: "product manager", location: "New York" });
  console.log(result.data.jobs);
  ```

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

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.linkedin.jobs.search(query="product manager", location="New York")
  print(result["data"]["jobs"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/linkedin/jobs/search \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"query":"product manager","location":"New York"}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy linkedin jobs search --query "product manager" --location "New York"
  ```
</CodeGroup>

The response:

```json theme={null}
{
  "success": true,
  "data": {
    "jobs": [
      {
        "id": "abc123",
        "url": "https://example.com/",
        "title": "Example title",
        "company": {
          "name": "Example title",
          "url": "https://example.com/",
          "avatar": "https://example.com/image.jpg"
        },
        "address": {
          "full": "example",
          "street": "example",
          "city": "example",
          "state": "example",
          "postalCode": "example",
          "country": "us"
        },
        "createdAt": "2026-09-28T12:00:00.000Z",
        "salaryText": "example",
        "isEasyApply": false,
        "insight": "example"
      }
    ]
  },
  "creditsUsed": 1,
  "requestId": "ebb0b21d-0691-4b56-a4d5-93a1e0f73575"
}
```

## Endpoints

| Endpoint | Cost |
| - | - |
| [Search LinkedIn jobs](/api-reference/endpoint/linkedin-jobs-search) | 1 credit per 10 items, at least 1 credit |
| [Get a LinkedIn job's details](/api-reference/endpoint/linkedin-jobs-job) | 1 credit |
| [Search Upwork jobs](/api-reference/endpoint/upwork-search) | 2 credits per 10 items, at least 2 credits |
| [Get an Upwork job's details](/api-reference/endpoint/upwork-job) | 3 credits |
| [Search Indeed jobs](/api-reference/endpoint/indeed-search) | 1 credit per 20 items, at least 1 credit |
| [Get an Indeed job's details](/api-reference/endpoint/indeed-job) | 1 credit |

## More ways to call it

### 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", limit: 20 });
  console.log(result.data.jobs);
  ```

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

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

  ```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","limit":20}'
  ```

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

### 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", limit: 25 });
  console.log(result.data.jobs);
  ```

  ```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", limit=25)
  print(result["data"]["jobs"])
  ```

  ```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","limit":25}'
  ```

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

<Tip>Pass the job URL from a search result into that site's job lookup endpoint for the full posting.</Tip>