{ "openapi": "3.0.1", "info": { "title": "Upwork Jobs Scraper - Client Spend & Job Alerts", "description": "Scrape Upwork jobs with the client panel a logged-out visitor sees: spend, hires, rating, reviews, member since, city and industry, plus exact proposal counts and job activity. No login. Job alerts with incremental mode. CSV, JSON, Excel.", "version": "0.2", "x-build-id": "mFhqab2OeaRqc13Au" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~upwork-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~upwork-jobs-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-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/parseforge~upwork-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-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": { "searchTerms": { "title": "๐Ÿ”Ž Search keywords", "type": "array", "description": "Keywords as you would type them in Upwork's job search, one search per line (for example python, shopify, logo design). Results are merged and de-duplicated on the job ID. Leave empty, with no URLs below, to list the newest postings across all of Upwork.", "items": { "type": "string" } }, "startUrls": { "title": "๐Ÿ”— Upwork job or search URLs", "type": "array", "description": "Optional. Paste job links (https://www.upwork.com/jobs/~02...) to read those postings, or job-search links copied from your browser after setting filters on upwork.com/nx/search/jobs (every filter in the link is applied, including category, budget, proposals and payment verified). The filters in this form do not apply to pasted URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000", "default": 20 }, "dataDepth": { "title": "๐Ÿงพ Data depth", "enum": [ "full", "basic" ], "type": "string", "description": "Full is the default. Basic is several times faster for very large pulls.", "default": "full" }, "incrementalMode": { "title": "๐Ÿ”” Only new or changed jobs (incremental mode)", "type": "boolean", "description": "For scheduled job alerts. The first run delivers the newest jobs and sets the starting point; every later run with the same search input returns only the jobs that appeared since, plus recent ones whose title, description, budget, level or length was edited. Jobs you already have are skipped and never charged. The memory is kept in a key-value store named upwork-jobs-scraper-state on your own account.", "default": false }, "stateKey": { "title": "Incremental memory name", "type": "string", "description": "Optional. Runs with the same name share one memory, even when their inputs differ. Change it to start over. Leave empty to key the memory on the search input." }, "sortBy": { "title": "Sort by", "enum": [ "recency", "relevance" ], "type": "string", "description": "Newest first also lets the posted-within window stop paging early.", "default": "recency" }, "jobTypes": { "title": "Payment type", "type": "array", "description": "Leave empty for both.", "items": { "type": "string", "enum": [ "hourly", "fixed" ], "enumTitles": [ "Hourly", "Fixed price" ] } }, "experienceLevels": { "title": "Experience level", "type": "array", "description": "Leave empty for all levels.", "items": { "type": "string", "enum": [ "EntryLevel", "IntermediateLevel", "ExpertLevel" ], "enumTitles": [ "Entry level", "Intermediate", "Expert" ] } }, "categories": { "title": "Category", "type": "array", "description": "Upwork's 12 top-level job categories.", "items": { "type": "string", "enum": [ "531770282584862721", "531770282580668416", "531770282580668417", "531770282580668420", "531770282580668421", "531770282584862722", "531770282580668419", "531770282584862723", "531770282580668422", "531770282584862720", "531770282580668418", "531770282580668423" ], "enumTitles": [ "Accounting & Consulting", "Admin Support", "Customer Service", "Data Science & Analytics", "Design & Creative", "Engineering & Architecture", "IT & Networking", "Legal", "Sales & Marketing", "Translation", "Web, Mobile & Software Dev", "Writing" ] } }, "subcategories": { "title": "Subcategory", "type": "array", "description": "Upwork's 64 subcategories. Pick a subcategory without its category to stay narrow.", "items": { "type": "string", "enum": [ "531770282601639943", "531770282601639945", "531770282601639944", "531770282601639947", "1534904461833879552", "531770282601639946", "531770282584862724", "531770282584862726", "531770282584862728", "531770282584862725", "1484275072572772352", "531770282584862730", "531770282593251329", "531770282593251330", "531770282593251331", "531770282589057038", "531770282593251335", "531770282593251341", "1044578476142100480", "531770282593251334", "1356688560628174848", "1356688565288046592", "531770282593251340", "531770282601639953", "1356688570056970240", "531770282601639948", "531770282601639949", "531770282605834240", "531770282601639950", "531770282605834241", "531770282601639951", "531770282601639952", "531770282605834242", "1301900647896092672", "531770282589057033", "531770282589057037", "531770282589057034", "531770282589057036", "531770282589057035", "531770282605834246", "531770283696353280", "1484275156546932736", "1484275408410693632", "531770282597445636", "531770282597445634", "531770282593251343", "1534904461842268160", "531770282601639939", "1737190722360750082", "1517518458442309632", "531770282589057025", "531770282589057026", "531770282589057027", "531770282589057024", "531770282589057032", "531770282589057030", "531770282589057031", "531770282589057028", "531770282589057029", "531770282584862733", "1301900640421842944", "531770282597445644", "531770282597445646", "1534904462131675136" ], "enumTitles": [ "Accounting & Consulting > Accounting & Bookkeeping", "Accounting & Consulting > Financial Planning", "Accounting & Consulting > Management Consulting & Analysis", "Accounting & Consulting > Other - Accounting & Consulting", "Accounting & Consulting > Personal & Professional Coaching", "Accounting & Consulting > Recruiting & Human Resources", "Admin Support > Data Entry & Transcription Services", "Admin Support > Market Research & Product Reviews", "Admin Support > Project Management", "Admin Support > Virtual Assistance", "Customer Service > Community Management & Tagging", "Customer Service > Customer Service & Tech Support", "Data Science & Analytics > AI & Machine Learning", "Data Science & Analytics > Data Analysis & Testing", "Data Science & Analytics > Data Extraction/ETL", "Data Science & Analytics > Data Mining & Management", "Design & Creative > Art & Illustration", "Design & Creative > Audio & Music Production", "Design & Creative > Branding & Logo Design", "Design & Creative > Graphic, Editorial & Presentation Design", "Design & Creative > NFT, AR/VR & Game Art", "Design & Creative > Performing Arts", "Design & Creative > Photography", "Design & Creative > Product Design", "Design & Creative > Video & Animation", "Engineering & Architecture > 3D Modeling & CAD", "Engineering & Architecture > Building & Landscape Architecture", "Engineering & Architecture > Chemical Engineering", "Engineering & Architecture > Civil & Structural Engineering", "Engineering & Architecture > Contract Manufacturing", "Engineering & Architecture > Electrical & Electronic Engineering", "Engineering & Architecture > Energy & Mechanical Engineering", "Engineering & Architecture > Interior & Trade Show Design", "Engineering & Architecture > Physical Sciences", "IT & Networking > Database Management & Administration", "IT & Networking > DevOps & Solution Architecture", "IT & Networking > ERP/CRM Software", "IT & Networking > Information Security & Compliance", "IT & Networking > Network & System Administration", "Legal > Corporate & Contract Law", "Legal > Finance & Tax Law", "Legal > International & Immigration Law", "Legal > Public Law", "Sales & Marketing > Digital Marketing", "Sales & Marketing > Lead Generation & Telemarketing", "Sales & Marketing > Marketing, PR & Brand Strategy", "Translation > Language Tutoring & Interpretation", "Translation > Translation & Localization Services", "Web, Mobile & Software Dev > AI Apps & Integration", "Web, Mobile & Software Dev > Blockchain, NFT & Cryptocurrency", "Web, Mobile & Software Dev > Desktop Application Development", "Web, Mobile & Software Dev > Ecommerce Development", "Web, Mobile & Software Dev > Game Design & Development", "Web, Mobile & Software Dev > Mobile Development", "Web, Mobile & Software Dev > Other - Software Development", "Web, Mobile & Software Dev > Product Management & Scrum", "Web, Mobile & Software Dev > QA Testing", "Web, Mobile & Software Dev > Scripts & Utilities", "Web, Mobile & Software Dev > Web & Mobile Design", "Web, Mobile & Software Dev > Web Development", "Writing > Content Writing", "Writing > Editing & Proofreading Services", "Writing > Professional & Business Writing", "Writing > Sales & Marketing Copywriting" ] } }, "hourlyRateMin": { "title": "Hourly rate from (USD)", "minimum": 0, "type": "integer", "description": "Hourly jobs whose rate range reaches at least this. Fixed-price jobs pass through unless you also pick Hourly as payment type." }, "hourlyRateMax": { "title": "Hourly rate to (USD)", "minimum": 0, "type": "integer", "description": "Hourly jobs whose rate range starts at or below this." }, "fixedBudgetMin": { "title": "Fixed budget from (USD)", "minimum": 0, "type": "integer", "description": "Fixed-price jobs with at least this budget. Hourly jobs pass through unless you also pick Fixed price as payment type." }, "fixedBudgetMax": { "title": "Fixed budget to (USD)", "minimum": 0, "type": "integer", "description": "Fixed-price jobs with at most this budget." }, "proposalsRanges": { "title": "Number of proposals", "type": "array", "description": "How many freelancers already applied.", "items": { "type": "string", "enum": [ "0-4", "5-9", "10-14", "15-19", "20-49", "50-" ], "enumTitles": [ "Less than 5 (low competition)", "5 to 9", "10 to 14", "15 to 19", "20 to 49", "50 or more" ] } }, "postedWithinHours": { "title": "Posted within the last N hours", "minimum": 1, "type": "integer", "description": "For example 1, 24 (one day) or 168 (one week). With newest-first sorting the run stops paging once postings get older, so a job alert every 15 minutes stays cheap." }, "clientPaymentVerifiedOnly": { "title": "Payment-verified clients only", "type": "boolean", "description": "Only jobs from clients with a verified payment method.", "default": false }, "clientLocations": { "title": "Client location", "type": "array", "description": "Regions, subregions or countries, spelled the way Upwork lists them. All 206 values were checked against the live search.", "items": { "type": "string", "enum": [ "Africa", "Americas", "Asia", "Europe", "Oceania", "Northern America", "Caribbean", "Central America", "South America", "Eastern Europe", "Western Europe", "Northern Europe", "Southern Europe", "Eastern Asia", "South-Eastern Asia", "Southern Asia", "Western Asia", "Central Asia", "Northern Africa", "Eastern Africa", "Western Africa", "Middle Africa", "Southern Africa", "Australia and New Zealand", "Melanesia", "Micronesia", "Polynesia", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belgium", "Belize", "Benin", "Bermuda", "Bolivia", "Botswana", "Brazil", "British Virgin Islands", "Bulgaria", "Burkina Faso", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Chad", "Chile", "China", "Colombia", "Congo, Democratic Republic of the", "Cook Islands", "Costa Rica", "Cote d'Ivoire", "Croatia", "Cyprus", "Czech Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Estonia", "Ethiopia", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Liechtenstein", "Lithuania", "Luxembourg", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Martinique", "Mauritania", "Mauritius", "Mexico", "Moldova", "Monaco", "Mongolia", "Montenegro", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nepal", "Netherlands", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Norfolk Island", "North Macedonia", "Norway", "Oman", "Pakistan", "Palestinian Territories", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russia", "Rwanda", "Samoa", "San Marino", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Somalia", "South Africa", "South Korea", "Spain", "Sri Lanka", "Swaziland", "Sweden", "Switzerland", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Togo", "Tunisia", "Turkey", "Turkmenistan", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "United States Minor Outlying Islands", "Uruguay", "Uzbekistan", "Venezuela", "Vietnam", "Yemen", "Zambia", "Zimbabwe" ], "enumTitles": [ "Region: Africa", "Region: Americas", "Region: Asia", "Region: Europe", "Region: Oceania", "Region: Northern America", "Region: Caribbean", "Region: Central America", "Region: South America", "Region: Eastern Europe", "Region: Western Europe", "Region: Northern Europe", "Region: Southern Europe", "Region: Eastern Asia", "Region: South-Eastern Asia", "Region: Southern Asia", "Region: Western Asia", "Region: Central Asia", "Region: Northern Africa", "Region: Eastern Africa", "Region: Western Africa", "Region: Middle Africa", "Region: Southern Africa", "Region: Australia and New Zealand", "Region: Melanesia", "Region: Micronesia", "Region: Polynesia", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belgium", "Belize", "Benin", "Bermuda", "Bolivia", "Botswana", "Brazil", "British Virgin Islands", "Bulgaria", "Burkina Faso", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Chad", "Chile", "China", "Colombia", "Congo, Democratic Republic of the", "Cook Islands", "Costa Rica", "Cote d'Ivoire", "Croatia", "Cyprus", "Czech Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Estonia", "Ethiopia", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Liechtenstein", "Lithuania", "Luxembourg", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Martinique", "Mauritania", "Mauritius", "Mexico", "Moldova", "Monaco", "Mongolia", "Montenegro", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nepal", "Netherlands", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Norfolk Island", "North Macedonia", "Norway", "Oman", "Pakistan", "Palestinian Territories", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russia", "Rwanda", "Samoa", "San Marino", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Somalia", "South Africa", "South Korea", "Spain", "Sri Lanka", "Swaziland", "Sweden", "Switzerland", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Togo", "Tunisia", "Turkey", "Turkmenistan", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "United States Minor Outlying Islands", "Uruguay", "Uzbekistan", "Venezuela", "Vietnam", "Yemen", "Zambia", "Zimbabwe" ] } }, "clientHires": { "title": "Client hiring history", "type": "array", "description": "How many freelancers the client has hired before.", "items": { "type": "string", "enum": [ "0", "1-9", "10-" ], "enumTitles": [ "No hires yet", "1 to 9 hires", "10 or more hires" ] } }, "clientMinTotalSpent": { "title": "Client spent at least (USD)", "minimum": 0, "type": "integer", "description": "Skips clients who spent less on Upwork, or who hide their spend." }, "clientMinRating": { "title": "Client rating at least (0 to 5)", "pattern": "^$|^[0-5](\\.[0-9]{1,2})?$", "type": "string", "description": "For example 4.5. Skips clients below it and clients with no reviews yet." }, "contractToHireOnly": { "title": "Contract-to-hire only", "type": "boolean", "description": "Only postings the client marked as possible full-time hires.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Set it only to force a proxy group or country.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }