$3 / 1k jobs
Extract Upwork job postings with their title, description, budget, required skills, and client details
Endpoint
POST /api/v1/agents/upwork/jobs/run
Parameters
array
required
List · Search keywords, Upwork job URLs, or Job IDs. One per line.
integer
default:50
Number · Jobs to return per query. Use 0 for all.
string
default:"relevance"
Dropdown · Sort order for results.Options:
relevance, newestLegend: relevance = Relevance, newest = Newest firstboolean
default:true
Toggle · Include jobs with hourly pricing.
integer
Number · Lowest hourly rate. Only applies when “Include Hourly Jobs” is on.
integer
Number · Highest hourly rate. Only applies when “Include Hourly Jobs” is on.
boolean
default:true
Toggle · Include jobs with a fixed total budget.
integer
Number · Lowest fixed budget. Only applies when “Include Fixed-Price Jobs” is on.
integer
Number · Highest fixed budget. Only applies when “Include Fixed-Price Jobs” is on.
array
Multi-select · Filter by required experience level.Options:
EntryLevel, IntermediateLevel, ExpertLevelLegend: EntryLevel = Entry Level, IntermediateLevel = Intermediate, ExpertLevel = Expertarray
Multi-select · Filter by the client’s hiring history on Upwork.Options:
0, 1-9, 10-Legend: 0 = No prior hires, 1-9 = 1-9 hires, 10- = 10+ hiresarray
Multi-select · Filter by project duration.Options:
week, month, semester, ongoingLegend: week = Less than a month, month = 1-3 months, semester = 3-6 months, ongoing = 6+ monthsarray
Multi-select · Filter by required commitment.Options:
part_time, full_timeLegend: part_time = Part-time (<30 hrs/week), full_time = Full-time (30+ hrs/week)array
List · Filter by client’s country (e.g. ‘United States’). One per line.
Response columns
| Field | Display name | Type |
|---|---|---|
jobUrl | Job URL | url |
jobTitle | Job Title | text |
description | Description | text |
status | Status | text |
contractorTier | Contractor Tier | text |
workload | Workload | text |
engagementDuration | Engagement Duration | text |
budget | Budget | currency |
extendedBudget | Extended Budget | text |
category | Category | text |
categoryGroup | Category Group | text |
postedOn | Posted On | text |
published | Published | text |
clientActivity | Client Activity | text |
annotations | Annotations | text |
sandsData | Sands Data | text |
segmentation | Segmentation | text |
openingInfo | Opening Info | text |
minHoursWeek | Min Hours/Week | number |
minJobSuccessScore | Min Job Success Score | number |
minUpworkHours | Min Upwork Hours | number |
englishSkill | English Skill | text |
risingTalentOk | Rising Talent OK | boolean |
portfolioRequired | Portfolio Required | boolean |
qualificationType | Qualification Type | text |
localMarket | Local Market | boolean |
locationCheck | Location Check | boolean |
buyerCompany | Buyer Company | text |
buyerJobs | Buyer Jobs | text |
buyerLocation | Buyer Location | text |
buyerStats | Buyer Stats | text |
paymentVerified | Payment Verified | boolean |
similarJobs | Similar Jobs | text |
topLevelDescription | Top-Level Description | text |
topLevelTitle | Top-Level Title | text |
Example
curl -X POST https://api.mindcase.co/api/v1/agents/upwork/jobs/run \
-H "Authorization: Bearer mk_live_abc123def456" \
-H "Content-Type: application/json" \
-d '{
"params": {
"jobIds": [
"1974229435317190991",
"1974184115785526950",
"1974229291820489729",
"1974229162153307814",
"1974229143502953454",
"1974229140898021711",
"1974229039236750318",
"1974183702387982672",
"1974228964049387855",
"1974183649217059822"
],
"limit": 10
}
}'
import requests
resp = requests.post(
"https://api.mindcase.co/api/v1/agents/upwork/jobs/run",
headers={"Authorization": "Bearer mk_live_abc123def456"},
json={"params": {
"jobIds": [
"1974229435317190991",
"1974184115785526950",
"1974229291820489729",
"1974229162153307814",
"1974229143502953454",
"1974229140898021711",
"1974229039236750318",
"1974183702387982672",
"1974228964049387855",
"1974183649217059822"
],
"limit": 10
}},
)
data = resp.json()
Example response
Response
{
"job_id": "job_7f3a2b1c",
"status": "completed",
"data": [
{
"jobUrl": "https://www.upwork.com/jobs/~022051005096520707758",
"jobTitle": "Creative Product Label Pouch Design",
"description": "We are seeking a talented freelancer to design creative product label pouches and manage product listings on Amazon. Additionally, the role involves creating posters for our product website. The ideal candidate should have a strong background in graphic design and experience with product listing. This is a part-time engagement with a project scale of small, expected to last less than a month.",
"status": "ACTIVE",
"contractorTier": "INTERMEDIATE",
"workload": null,
"engagementDuration": "Less than 1 month",
"budget": 500,
"extendedBudget": null,
"category": "Graphic, Editorial & Presentation Design",
"categoryGroup": "Design & Creative",
"postedOn": "2026-05-03T18:24:55.887Z",
"published": "2026-05-03T18:57:01.665Z",
"clientActivity": {
"lastBuyerActivity": "2026-05-03T18:57:01.665Z",
"totalApplicants": 0,
"totalHired": 0,
"totalInvitedToInterview": 0,
"unansweredInvites": 0,
"invitationsSent": 0,
"numberOfPositionsToHire": 1,
"interviewRatio": "0%",
"lastOnlineTime": "0 minutes ago"
},
"annotations": {
"tags": [
"reimagined",
"jpgV2Generated",
"firstJobPost",
"searchable"
]
},
"sandsData": {
"occupation": {
"freeText": null,
"ontologyId": "upworkOccupation:graphicdesign",
"prefLabel": "Graphic Design",
"id": "1017484851352698959",
"uid": "1017484851352698959"
},
"ontologySkills": [
{
"groupId": "1356688448220827648",
"id": "1052162208856592384",
"freeText": null,
"prefLabel": "Packaging Design",
"groupPrefLabel": "Graphic Design Services",
"relevance": "MANDATORY"
},
{
"groupId": "1356688448220827648",
"id": "1031626742929276928",
"freeText": null,
"prefLabel": "Graphic Design",
"groupPrefLabel": "Graphic Design Services",
"relevance": "MANDATORY"
},
{
"groupId": "1049251003490410499",
"id": "1052162208852398098",
"freeText": null,
"prefLabel": "Adobe Photoshop",
"groupPrefLabel": "Graphic Design Software",
"relevance": "NICE_TO_HAVE"
},
{
"groupId": "1356688448220827648",
"id": "1031626767235268608",
"freeText": null,
"prefLabel": "Label & Packaging Design",
"groupPrefLabel": "Graphic Design Services",
"relevance": "NICE_TO_HAVE"
}
],
"additionalSkills": null
},
"segmentation": [
{
"customValue": null,
"label": "One-time project",
"name": "Employment",
"sortOrder": 0,
"type": "EMPLOYMENT",
"value": "EMPLOYMENT_PROJECT",
"skill": null
}
],
"openingInfo": {
"ciphertext": "~022051005096520707758",
"id": "2051005096520707758",
"type": "FIXED",
"access": "PUBLIC_INDEX",
"title": "Creative Product Label Pouch Design",
"hideBudget": false,
"createdOn": "2026-05-03T18:24:55.887Z",
"notSureProjectDuration": false,
"notSureFreelancersToHire": false,
"notSureExperienceLevel": false,
"notSureLocationPreference": false,
"premium": false
},
"minHoursWeek": null,
"minJobSuccessScore": 0,
"minUpworkHours": 0,
"englishSkill": "ANY",
"risingTalentOk": false,
"portfolioRequired": false,
"qualificationType": "ANY",
"localMarket": false,
"locationCheck": false,
"buyerCompany": {
"isEDCReplicated": null,
"contractDate": "2024-12-14T00:00:00.000Z",
"profile": {
"industry": null,
"size": null
}
},
"buyerJobs": {
"openCount": 1,
"openJobs": [
{
"id": "2051005096520707758",
"uid": "2051005096520707758",
"isPtcPrivate": false,
"ciphertext": "~022051005096520707758",
"title": "Creative Product Label Pouch Design",
"type": "FIXED"
}
]
},
"buyerLocation": {
"offsetFromUtcMillis": 19800000,
"countryTimezone": "Asia/Calcutta (UTC+05:30)",
"city": null,
"country": "India"
},
"buyerStats": {
"totalAssignments": 0,
"activeAssignmentsCount": 0,
"hoursCount": 0,
"feedbackCount": 0,
"score": 0,
"totalJobsWithHires": 0,
"totalCharges": null
},
"paymentVerified": false,
"similarJobs": [
{
"id": null,
"ciphertext": "~021961461537889921207",
"title": "VSP Logo Re-imagined",
"description": "Hello, I am looking for help with our logo. It is basic and outdated and doesn't print well on marketing materials and apparel. I would like to explore alternative versions of our logo for Verde Solar Power. We have a sister company called Verde Roofing Partners and we recently created that logo so I will attach that here so you can see the direction we are moving in. I will also share the wraps we put on our vehicles so you can see our branding overall.",
"engagement": "Less than 30 hrs/week",
"durationLabel": "Less than 1 month",
"contractorTier": "INTERMEDIATE",
"type": "HOURLY",
"createdOn": "2025-08-29T16:10:47+0000",
"renewedOn": null,
"amount": {
"amount": 0
},
"maxAmount": null,
"ontologySkills": [
{
"id": null,
"prefLabel": "Logo Design"
},
{
"id": null,
"prefLabel": "Graphic Design"
},
{
"id": null,
"prefLabel": "Print Design"
},
{
"id": null,
"prefLabel": "Brand Positioning"
},
{
"id": null,
"prefLabel": "Branding"
}
],
"hourlyBudgetMin": 0,
"hourlyBudgetMax": 0
},
{
"id": null,
"ciphertext": "~021975740571693857179",
"title": "Fix T-Shirt Artwork - Anti-Alias/Ghost on Artwork",
"description": "I have a T-shirt transfer file that has a demon character in it. The character has a white fade/ghost/halo that I can't seem to get rid of with a transparent background. \n\nCan someone help me.\n\nSee attached file.\n\nHere is some info I found:\n\nIn DTF transfers, a file with a black edge can show a white halo for two main reasons: transparent pixels in the graphic file or a misalignment of the printer's white underbase layer.\n1. Transparent pixels in the file\nThis is the most common cause and is a file-preparation issue, not a printer error. A file that appears to have solid edges on screen may actually contain semi-transparent pixels, particularly if it was created in or exported from a raster program like Photoshop.\nAnti-aliasing: The process of anti-aliasing, which smooths the appearance of text and curves, can create semi-transparent pixels at the edges of a design.\nImproper background removal: If the original file had a background that was not removed perfectly, residual semi-transparent pixels can be left behind.\nThe DTF process: When the DTF printer lays down its opaque white ink underbase, it applies ink to any area with even a slight degree of transparency, causing a visible white outline.\n\nFor file issues\nRefine edges in Photoshop: Use the \"Defringe\" command or manually contract your selection by a pixel or two before deleting the background.\nUse a Threshold adjustment: In Photoshop, convert the semi-transparent edge pixels to either fully opaque or fully transparent pixels using the Image Adjustments Threshold command.\nCheck against a colored background: Before printing, place a colored background layer behind your design in your editing software to reveal any leftover semi-transparent pixels.\nExport as a vector: Vector files are resolution-independent and won't have the pixelation issues that cause transparent edges.",
"engagement": null,
"durationLabel": "Less than 1 month",
"contractorTier": "EXPERT",
"type": "FIXED",
"createdOn": "2025-10-08T01:50:34+0000",
"renewedOn": null,
"amount": {
"amount": 10
},
"maxAmount": null,
"ontologySkills": [
{
"id": null,
"prefLabel": "Adobe Illustrator"
},
{
"id": null,
"prefLabel": "Graphic Design"
},
{
"id": null,
"prefLabel": "Print Design"
},
{
"id": null,
"prefLabel": "Adobe Photoshop"
}
],
"hourlyBudgetMin": 0,
"hourlyBudgetMax": 0
},
{
"id": null,
"ciphertext": "~021976976052218600960",
"title": "A frame design",
"description": "Looking for a graphic designer to design an A-frame for my company already have a draft and just need it to be updated to the company colours and make it look professional.",
"engagement": null,
"durationLabel": "Less than 1 month",
"contractorTier": "INTERMEDIATE",
"type": "FIXED",
"createdOn": "2025-10-11T11:39:56+0000",
"renewedOn": null,
"amount": {
"amount": 25
},
"maxAmount": null,
"ontologySkills": [
{
"id": null,
"prefLabel": "Business Card"
},
{
"id": null,
"prefLabel": "Logo Design"
},
{
"id": null,
"prefLabel": "Poster Design"
},
{
"id": null,
"prefLabel": "Flyer Design"
},
{
"id": null,
"prefLabel": "Graphic Design"
},
{
"id": null,
"prefLabel": "Social Media Content Creation"
},
{
"id": null,
"prefLabel": "Branding Template"
},
{
"id": null,
"prefLabel": "Branding"
}
],
"hourlyBudgetMin": 0,
"hourlyBudgetMax": 0
},
{
"id": null,
"ciphertext": "~021974310115131354790",
"title": "Graphic designer for food specials menu",
"description": "We are seeking a talented graphic designer to create visually appealing Fall/Winter Food specials menus, pics and post for our restaurant. Please read the attached write up pdf for all the details. All content and requirements is included in the write up and you will also find our logo attached as well as another sample. \nPlease also visit our Pinterest board for more inspiration\nThank you for your interest.\n\nhttps://ca.pinterest.com/mikesilas/typhoon-fall-menu-specials/",
"engagement": null,
"durationLabel": "Less than 1 month",
"contractorTier": "INTERMEDIATE",
"type": "FIXED",
"createdOn": "2025-10-04T03:06:27+0000",
"renewedOn": null,
"amount": {
"amount": 325
},
"maxAmount": null,
"ontologySkills": [
{
"id": null,
"prefLabel": "Graphic Design"
},
{
"id": null,
"prefLabel": "Adobe Photoshop"
},
{
"id": null,
"prefLabel": "Adobe Illustrator"
}
],
"hourlyBudgetMin": 0,
"hourlyBudgetMax": 0
}
],
"topLevelDescription": null,
"topLevelTitle": null
}
]
}