Skip to main content
POST
Search Upwork jobs
  • Endpoint: upwork.search
  • Returns: data has jobs, total.
  • Cost: 2 credits per 10 items, at least 2 credits. Failed calls cost nothing.
  • Paging: Yes. Send the cursor from the response to get the next page. See Paging.

Example

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string
Required string length: 1 - 200
sort
enum<string>
default:newest
Available options:
newest,
relevance
jobType
enum<string>
Available options:
hourly,
fixed
experience
enum<string>[]
Minimum array length: 1
Available options:
entry,
intermediate,
expert
duration
enum<string>[]
Minimum array length: 1
Available options:
week,
month,
semester,
ongoing
workload
enum<string>[]
Minimum array length: 1
Available options:
asNeeded,
partTime,
fullTime
clientHires
enum<string>[]
Minimum array length: 1
Available options:
none,
oneToNine,
tenPlus
hourlyRate
object
contractToHire
boolean
locations
string[]
Required array length: 1 - 20 elements
Required string length: 2 - 80
timezones
string[]
Required array length: 1 - 20 elements
Required string length: 2 - 60
limit
integer
default:20
Required range: 1 <= x <= 200
cursor
string
Pattern: ^\d{1,7}$

Response

The data, and the credits this call used.

success
any
required
data
object
required
creditsUsed
integer
required
requestId
string
required