Skip to main content
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.
string
required
Search keyword or phrase to find Upwork job postings (e.g. ‘python developer’).
integer
Number of jobs to return (5-500). Use 0 for all.Min 5; max 500.
string
default:"relevance"
Sort order for results.Allowed values: relevance (Relevance), newest (Newest first).
boolean
default:"true"
Include jobs with hourly pricing.
integer
Lowest hourly rate. Only applies when “Include Hourly Jobs” is on.
integer
Highest hourly rate. Only applies when “Include Hourly Jobs” is on.
boolean
default:"true"
Include jobs with a fixed total budget.
integer
Lowest fixed budget. Only applies when “Include Fixed-Price Jobs” is on.
integer
Highest fixed budget. Only applies when “Include Fixed-Price Jobs” is on.
string[]
Filter by required experience level.Allowed values: EntryLevel (Entry Level), IntermediateLevel (Intermediate), ExpertLevel (Expert).
string[]
Filter by the client’s hiring history on Upwork.Allowed values: 0 (No prior hires), 1-9 (1-9 hires), 10- (10+ hires).
string[]
Filter by project duration.Allowed values: week (Less than a month), month (1-3 months), semester (3-6 months), ongoing (6+ months).
string[]
Filter by required commitment.Allowed values: part_time (Part-time (<30 hrs/week)), full_time (Full-time (30+ hrs/week)).
string[]
Filter results by the client’s country (e.g. ‘United States’).

Example

Response fields

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

Example response

Abridged: long text and lists are shortened.