SOCIAL MEDIA

Search Upwork Jobs API

Search Upwork job postings by keyword. Returns title, description, contract type, budget, publish time and the job reference you pass to upwork-jobs-detail. Reads Upwork's public visitor surface — no Upwork account or cookie is required.

Part of: Upwork Jobs Scraper API

upworkjobsfreelancehiringsearchscraping

Try it free Get an API key

How to call it

Send one POST to api.upapi.io/upwork-jobs-search.get with your key in the X-Api-Key header and the parameters below as a JSON body. Each call spends 10 weighted units of your monthly quota. The operation times out after 45 seconds. Identical requests are served from cache for 180 seconds, unbilled.

endpoint

POST https://api.upapi.io/upwork-jobs-search.get

Search Upwork Jobs API reference

Request parameters

page: integer — 1-based results page.
sort: string — Result order: recency (newest first) or relevance.
query: stringrequired — What to search for (e.g. "python developer", "react native app")
jobType: string — Contract type filter: any, hourly or fixed.
pageSize: integer — Postings per page, 1-50.
proxyUrl: string — User-provided proxy URL. Omit to use the operation's own pool.
experienceLevel: string — Required experience: any, entry, intermediate or expert.

Response fields

jobs: arrayrequired
jobs[].jobId: stringrequired
jobs[].title: stringrequired
jobs[].jobUrl: stringrequired
jobs[].jobType: stringrequired
jobs[].ciphertext: stringrequired
jobs[].description: stringrequired
jobs[].publishTime: stringrequired
jobs[].hourlyBudgetMax: numberrequired
jobs[].hourlyBudgetMin: numberrequired
jobs[].fixedPriceAmount: numberrequired
page: integerrequired
query: stringrequired
hasMore: booleanrequired
pageSize: integerrequired
elapsedMs: integerrequired
fetchedAt: stringrequired
totalFound: integerrequired
resultCount: integerrequired

Example request and response

The example response is generated from this operation’s published output schema — it shows the shape and field names, not values from a recorded call.

json — example request body

{
  "page": 1,
  "sort": "recency",
  "query": "python developer",
  "jobType": "any",
  "pageSize": 20,
  "experienceLevel": "any"
}

json — example response shape

{
  "jobs": [
    {
      "jobId": "example",
      "title": "Alan Turing",
      "jobUrl": "example",
      "jobType": "example",
      "ciphertext": "example",
      "description": "example",
      "publishTime": "example",
      "hourlyBudgetMax": 1,
      "hourlyBudgetMin": 1,
      "fixedPriceAmount": 1
    }
  ],
  "page": 1,
  "query": "typescript",
  "hasMore": false,
  "pageSize": 5,
  "elapsedMs": 1,
  "fetchedAt": "example",
  "totalFound": 1,
  "resultCount": 1
}

Code snippets

cURL

curl

curl -X POST https://api.upapi.io/upwork-jobs-search.get \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "page": 1, "sort": "recency", "query": "python developer", "jobType": "any", "pageSize": 20, "experienceLevel": "any" }'

JavaScript

javascript

const response = await fetch('https://api.upapi.io/upwork-jobs-search.get', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
  "page": 1,
  "sort": "recency",
  "query": "python developer",
  "jobType": "any",
  "pageSize": 20,
  "experienceLevel": "any"
}),
});

const data = await response.json();
console.log(data);

Python

python

import requests

response = requests.post(
    'https://api.upapi.io/upwork-jobs-search.get',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY',
    },
    json={
  "page": 1,
  "sort": "recency",
  "query": "python developer",
  "jobType": "any",
  "pageSize": 20,
  "experienceLevel": "any"
},
)

print(response.json())

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{ "page": 1, "sort": "recency", "query": "python developer", "jobType": "any", "pageSize": 20, "experienceLevel": "any" }`)

	req, _ := http.NewRequest("POST", "https://api.upapi.io/upwork-jobs-search.get", bytes.NewBuffer(payload))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("x-api-key", "YOUR_API_KEY")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	var result map[string]any
	json.Unmarshal(body, &result)
	fmt.Println(result)
}

PHP

php

<?php

$payload = json_encode([
    'page' => 1,
    'sort' => 'recency',
    'query' => 'python developer',
    'jobType' => 'any',
    'pageSize' => 20,
    'experienceLevel' => 'any',
]);

$ch = curl_init('https://api.upapi.io/upwork-jobs-search.get');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'x-api-key: YOUR_API_KEY',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
var_dump($data);

Ruby

ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.upapi.io/upwork-jobs-search.get')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'

request = Net::HTTP::Post.new(uri.path)
request['Content-Type'] = 'application/json'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = { "page": 1, "sort": "recency", "query": "python developer", "jobType": "any", "pageSize": 20, "experienceLevel": "any" }.to_json

response = http.request(request)
puts JSON.parse(response.body)

Java

java

import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;

OkHttpClient client = new OkHttpClient();
ObjectMapper mapper = new ObjectMapper();

String json = "{ \"page\": 1, \"sort\": \"recency\", \"query\": \"python developer\", \"jobType\": \"any\", \"pageSize\": 20, \"experienceLevel\": \"any\" }";

RequestBody body = RequestBody.create(json, MediaType.get("application/json"));
Request request = new Request.Builder()
    .url("https://api.upapi.io/upwork-jobs-search.get")
    .post(body)
    .addHeader("Content-Type", "application/json")
    .addHeader("x-api-key", "YOUR_API_KEY")
    .build();

try (Response response = client.newCall(request).execute()) {
    Map<?, ?> result = mapper.readValue(response.body().string(), Map.class);
    System.out.println(result);
}

csharp

using System.Net.Http;
using System.Net.Http.Json;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var payload = JsonSerializer.Deserialize<object>("{ \"page\": 1, \"sort\": \"recency\", \"query\": \"python developer\", \"jobType\": \"any\", \"pageSize\": 20, \"experienceLevel\": \"any\" }");
var response = await client.PostAsJsonAsync("https://api.upapi.io/upwork-jobs-search.get", payload);

var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(result);

Frequently asked questions

How much does the Search Upwork Jobs API cost per call?

Each call spends 10 weighted units of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.

How do I authenticate to the Search Upwork Jobs API?

Send your key in the X-Api-Key header. A free guest key is available without creating an account.

Are Search Upwork Jobs API responses cached?

Yes — identical requests are served from cache for 180 seconds, and a cache hit is not billed.

More Social Media APIs

Get Upwork Job Details Search LinkedIn Jobs Get Contra Opportunity Get LinkedIn Job Details Wellfound Browse Jobs Wellfound Search Jobs TikTok Get Comment Replies TikTok Get Comments

Browse every Social Media API →