{
  "openapi": "3.0.1",
  "info": {
    "title": "Upwork Jobs Scraper: New Jobs in 2 Minutes, Client Data",
    "description": "Upwork Jobs Scraper for real-time job alerts: new jobs 2 to 3 minutes after posting, with client country, spend, rating and exact proposals count. Keywords or search URLs, filters, new-jobs-only monitoring. No account.",
    "version": "0.1",
    "x-build-id": "tgDFmF4G38W8ZZtVu"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/alexmorain~upwork-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-alexmorain-upwork-jobs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/alexmorain~upwork-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-alexmorain-upwork-jobs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/alexmorain~upwork-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-alexmorain-upwork-jobs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "One search per line, such as <code>python</code>, <code>shopify developer</code> or <code>\"data entry\"</code>. Upwork searches titles, descriptions and skills. Jobs come newest first. Leave empty if you paste search URLs or pick categories below.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Upwork search URLs",
            "type": "array",
            "description": "Searches copied from your browser, one per line, such as <code>https://www.upwork.com/nx/search/jobs/?q=python&amp;t=1&amp;amount=500-999</code>. The keyword, job type, experience level, budget, hourly rate, client history, project length, hours per week, client location, category, payment verified and number of proposals filters are read from the URL. The sort order is always newest first. The filters below apply to keywords only, not to pasted URLs.",
            "items": {
              "type": "string"
            }
          },
          "jobType": {
            "title": "Job type",
            "enum": [
              "any",
              "hourly",
              "fixed"
            ],
            "type": "string",
            "description": "Hourly jobs have a rate range, fixed-price jobs a budget. A budget or hourly rate filter below sets this for you.",
            "default": "any"
          },
          "experienceLevel": {
            "title": "Experience level",
            "type": "array",
            "description": "Entry level, intermediate or expert, as the client chose it. Several allowed.",
            "items": {
              "type": "string",
              "enum": [
                "entry",
                "intermediate",
                "expert"
              ],
              "enumTitles": [
                "Entry level",
                "Intermediate",
                "Expert"
              ]
            }
          },
          "minBudget": {
            "title": "Minimum fixed budget (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only fixed-price jobs with a budget of at least this amount. Setting a budget limits the search to fixed-price jobs."
          },
          "maxBudget": {
            "title": "Maximum fixed budget (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only fixed-price jobs with a budget of at most this amount."
          },
          "minHourlyRate": {
            "title": "Minimum hourly rate (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only hourly jobs whose rate reaches at least this amount. Setting a rate limits the search to hourly jobs. With both a budget and a rate, the actor runs two searches."
          },
          "maxHourlyRate": {
            "title": "Maximum hourly rate (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only hourly jobs paying at most this amount per hour."
          },
          "clientCountries": {
            "title": "Client countries",
            "type": "array",
            "description": "Only jobs from clients located in these countries, written the way Upwork does: <code>United States</code>, <code>United Kingdom</code>, <code>Germany</code>. One per line.",
            "items": {
              "type": "string"
            }
          },
          "clientHistory": {
            "title": "Client history",
            "type": "array",
            "description": "How many freelancers the client already hired on Upwork. Handy to skip new clients, or to find the ones who never hired.",
            "items": {
              "type": "string",
              "enum": [
                "0",
                "1-9",
                "10-"
              ],
              "enumTitles": [
                "No hires yet",
                "1 to 9 hires",
                "10 or more hires"
              ]
            }
          },
          "projectLength": {
            "title": "Project length",
            "type": "array",
            "description": "Expected duration of hourly jobs.",
            "items": {
              "type": "string",
              "enum": [
                "week",
                "month",
                "semester",
                "ongoing"
              ],
              "enumTitles": [
                "Less than 1 month",
                "1 to 3 months",
                "3 to 6 months",
                "More than 6 months"
              ]
            }
          },
          "hoursPerWeek": {
            "title": "Hours per week",
            "enum": [
              "any",
              "lessThan30",
              "moreThan30"
            ],
            "type": "string",
            "description": "For hourly jobs.",
            "default": "any"
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "The 12 Upwork categories. Several allowed. With no keyword, you get every new job of these categories.",
            "items": {
              "type": "string",
              "enum": [
                "Accounting & Consulting",
                "Admin Support",
                "Customer Service",
                "Data Science & Analytics",
                "Design & Creative",
                "Engineering & Architecture",
                "IT & Networking",
                "Legal",
                "Sales & Marketing",
                "Translation",
                "Web, Mobile & Software Dev",
                "Writing"
              ]
            }
          },
          "contractToHire": {
            "title": "Contract-to-hire only",
            "type": "boolean",
            "description": "Only jobs the client may turn into a full-time hire.",
            "default": false
          },
          "maxAgeMinutes": {
            "title": "Only jobs published in the last N minutes",
            "minimum": 1,
            "type": "integer",
            "description": "The cheap way to get alerts: <code>60</code> returns only the jobs published in the last hour, so a run every few minutes reads one page. Leave empty for no limit."
          },
          "maxApplicants": {
            "title": "Maximum proposals",
            "minimum": 0,
            "type": "integer",
            "description": "Only jobs with at most this many proposals so far, for example <code>5</code> to be among the first. Needs the job details: each job is read in full and billed as <b>job with details</b>. Jobs that fail the filter are not billed."
          },
          "paymentVerifiedOnly": {
            "title": "Payment verified clients only",
            "type": "boolean",
            "description": "Needs the job details (billed as job with details; rejected jobs are not billed).",
            "default": false
          },
          "minClientSpent": {
            "title": "Minimum client spend (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Only clients who already spent at least this much on Upwork. A new client has no spend and is left out. Needs the job details (rejected jobs are not billed)."
          },
          "minClientRating": {
            "title": "Minimum client rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Only clients rated at least this (0 to 5). A client with no feedback yet is left out. Needs the job details (rejected jobs are not billed)."
          },
          "maxRejectedReads": {
            "title": "Stop after this many rejected reads",
            "minimum": 0,
            "type": "integer",
            "description": "Safety net for the client filters (proposals, spend, rating, payment verified). Each job whose details were read and then rejected is free for you but costs a request. The run stops when this many jobs were rejected and they outnumber the delivered ones 20 to 1. <code>0</code> = no guard.",
            "default": 2000
          },
          "includeDetails": {
            "title": "Read the job details",
            "type": "boolean",
            "description": "Adds the client panel (country, total spent, rating, hires, payment verified, member since) and the exact number of proposals, interviews and invites. Billed as <b>job with details</b>. About 1 job in 10 is private (Upwork asks for a login): it is delivered with the search fields only and billed as a plain <b>job</b>.",
            "default": false
          },
          "maxItems": {
            "title": "Max jobs",
            "minimum": 0,
            "type": "integer",
            "description": "Stops the whole run after this many jobs. <code>0</code> = no limit: a broad search then returns everything Upwork holds, split into slices so the 5,050-result wall of a single search does not cut it.",
            "default": 100
          },
          "newOnly": {
            "title": "New jobs only (monitoring)",
            "type": "boolean",
            "description": "Delivers each job once: jobs a previous run of the same monitor already saw are skipped and never billed. Schedule the run every few minutes for alerts. The first run delivers what the search returns now (set <b>Max jobs</b> or the minutes limit to keep it small). Needs <b>Monitor name</b> if you run several monitors with the same searches.",
            "default": false
          },
          "registryKey": {
            "title": "Monitor name",
            "type": "string",
            "description": "Names the list of jobs already seen. Empty = derived from your searches and filters, so the same input shares one list. Use a name to keep two monitors apart."
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "POST of a JSON summary (run id, dataset id, jobs delivered, status) when the run ends. Slack and Discord incoming webhooks, Zapier and Make URLs work. The jobs themselves stay in the dataset."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}