Skip to main content

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.

$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

inputs
array
required
List · Search keywords, Upwork job URLs, or Job IDs. One per line.
limit
integer
default:50
Number · Jobs to return per query. Use 0 for all.
sortBy
string
default:"relevance"
Dropdown · Sort order for results.Options: relevance, newestLegend: relevance = Relevance, newest = Newest first
isHourly
boolean
default:true
Toggle · Include jobs with hourly pricing.
hourlyMinPrice
integer
Number · Lowest hourly rate. Only applies when “Include Hourly Jobs” is on.
hourlyMaxPrice
integer
Number · Highest hourly rate. Only applies when “Include Hourly Jobs” is on.
isFixed
boolean
default:true
Toggle · Include jobs with a fixed total budget.
fixedMinPrice
integer
Number · Lowest fixed budget. Only applies when “Include Fixed-Price Jobs” is on.
fixedMaxPrice
integer
Number · Highest fixed budget. Only applies when “Include Fixed-Price Jobs” is on.
experienceLevel
array
Multi-select · Filter by required experience level.Options: EntryLevel, IntermediateLevel, ExpertLevelLegend: EntryLevel = Entry Level, IntermediateLevel = Intermediate, ExpertLevel = Expert
clientHistory
array
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+ hires
projectLength
array
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+ months
hoursPerWeek
array
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)
location
array
List · Filter by client’s country (e.g. ‘United States’). One per line.

Response columns

FieldDisplay nameType
jobUrlJob URLurl
jobTitleJob Titletext
descriptionDescriptiontext
statusStatustext
contractorTierContractor Tiertext
workloadWorkloadtext
engagementDurationEngagement Durationtext
budgetBudgetcurrency
extendedBudgetExtended Budgettext
categoryCategorytext
categoryGroupCategory Grouptext
postedOnPosted Ontext
publishedPublishedtext
clientActivityClient Activitytext
annotationsAnnotationstext
sandsDataSands Datatext
segmentationSegmentationtext
openingInfoOpening Infotext
minHoursWeekMin Hours/Weeknumber
minJobSuccessScoreMin Job Success Scorenumber
minUpworkHoursMin Upwork Hoursnumber
englishSkillEnglish Skilltext
risingTalentOkRising Talent OKboolean
portfolioRequiredPortfolio Requiredboolean
qualificationTypeQualification Typetext
localMarketLocal Marketboolean
locationCheckLocation Checkboolean
buyerCompanyBuyer Companytext
buyerJobsBuyer Jobstext
buyerLocationBuyer Locationtext
buyerStatsBuyer Statstext
paymentVerifiedPayment Verifiedboolean
similarJobsSimilar Jobstext
topLevelDescriptionTop-Level Descriptiontext
topLevelTitleTop-Level Titletext

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

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