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

# Upwork Jobs API

> Extract Upwork job postings with their title, description, budget, required skills, and client details

`POST /v1/data/upwork/jobs/run`

**Pricing:** $0.003 per job ($3.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**inputs** `string` *required*

Search keyword or phrase to find Upwork job postings (e.g. 'python developer').

**limit** `integer`

Number of jobs to return (5-500). Use 0 for all.

Min `5`; max `500`.

**sortBy** `string` (default: relevance)

Sort order for results.

Allowed values: `relevance` (Relevance), `newest` (Newest first).

**isHourly** `boolean` (default: true)

Include jobs with hourly pricing.

**hourlyMinPrice** `integer`

Lowest hourly rate. Only applies when "Include Hourly Jobs" is on.

**hourlyMaxPrice** `integer`

Highest hourly rate. Only applies when "Include Hourly Jobs" is on.

**isFixed** `boolean` (default: true)

Include jobs with a fixed total budget.

**fixedMinPrice** `integer`

Lowest fixed budget. Only applies when "Include Fixed-Price Jobs" is on.

**fixedMaxPrice** `integer`

Highest fixed budget. Only applies when "Include Fixed-Price Jobs" is on.

**experienceLevel** `string[]`

Filter by required experience level.

Allowed values: `EntryLevel` (Entry Level), `IntermediateLevel` (Intermediate), `ExpertLevel` (Expert).

**clientHistory** `string[]`

Filter by the client's hiring history on Upwork.

Allowed values: `0` (No prior hires), `1-9` (1-9 hires), `10-` (10+ hires).

**projectLength** `string[]`

Filter by project duration.

Allowed values: `week` (Less than a month), `month` (1-3 months), `semester` (3-6 months), `ongoing` (6+ months).

**hoursPerWeek** `string[]`

Filter by required commitment.

Allowed values: `part_time` (Part-time (\<30 hrs/week)), `full_time` (Full-time (30+ hrs/week)).

**location** `string[]`

Filter results by the client's country (e.g. 'United States').

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/upwork/jobs/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "inputs": "python developer",
    "limit": 10
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/upwork/jobs/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "inputs": "python developer",
    "limit": 10
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/upwork/jobs/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "inputs": "python developer",
  "limit": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one job, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `jobTitle` | Job Title | text |
| `jobUrl` | Job URL | url |
| `jobId` | Job ID | text |
| `jobDescription` | Job Description | text |
| `jobAccess` | Job Access | text |
| `jobStatus` | Job Status | text |
| `posted` | Posted | text |
| `jobType` | Job Type | text |
| `fixedBudget` | Fixed Budget | currency |
| `hourlyRateMin` | Hourly Rate Min | currency |
| `hourlyRateMax` | Hourly Rate Max | currency |
| `experienceLevel` | Experience Level | text |
| `projectLength` | Project Length | text |
| `weeklyWorkload` | Weekly Workload | text |
| `category` | Category | text |
| `categoryGroup` | Category Group | text |
| `occupation` | Occupation | text |
| `skills` | Skills | object\_array |
| `skillGroups` | Skill Groups | object\_array |
| `projectType` | Project Type | text |
| `featuredJob` | Featured Job | boolean |
| `contractToHire` | Contract To Hire | boolean |
| `positionsToHire` | Positions To Hire | number |
| `applicants` | Applicants | number |
| `interviewing` | Interviewing | number |
| `invitesSent` | Invites Sent | number |
| `unansweredInvites` | Unanswered Invites | number |
| `hired` | Hired | number |
| `client` | Client | object |
| `clientOtherOpenPostings` | Client Other Open Postings | object\_array |
| `similarJobs` | Similar Jobs | object\_array |
| `minJobSuccessScore` | Min Job Success Score | number |
| `englishLevel` | English Level | text |
| `risingTalentOk` | Rising Talent OK | boolean |
| `freelancerType` | Freelancer Type | text |
| `localMarketJob` | Local Market Job | boolean |
| `locationCheckRequired` | Location Check Required | boolean |
| `requiredCountries` | Required Countries | array |
| `requiredRegions` | Required Regions | array |
| `requiredLanguages` | Required Languages | array |
| `requiredTimezones` | Required Timezones | array |
| `deadline` | Deadline | text |
| `hourlyBudgetSource` | Hourly Budget Source | text |
| `resultRank` | Result Rank | number |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "upwork/jobs",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "hourlyRateMax": null,
      "occupation": null,
      "skillGroups": [],
      "jobType": "HOURLY",
      "fixedBudget": null,
      "locationCheckRequired": null,
      "jobTitle": "Python developer",
      "projectLength": "Less than 1 month",
      "requiredLanguages": null,
      "requiredCountries": null,
      "positionsToHire": null,
      "jobDescription": "Python Developer – Interactive Brokers (IBKR) Trading Automation\n\nWe are a quantitative trading firm seeking an experienced Python developer to build the tec...",
      "client": null,
      "freelancerType": null,
      "posted": "2026-08-03T14:08:40.187Z",
      "categoryGroup": null,
      "deadline": null,
      "applicants": null,
      "jobId": "2084279516251379917",
      "invitesSent": null,
      "hired": null,
      "clientOtherOpenPostings": [],
      "jobAccess": "Private",
      "experienceLevel": "Intermediate",
      "minJobSuccessScore": null
    }
  ]
}
```


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