{ "openapi": "3.0.1", "info": { "title": "Upwork Jobs Scraper API - Budgets, Skills & Client History", "description": "💼 Stay on top of new Upwork jobs that match your search. Keyword, category, job type, hourly rate or budget, skills, experience level and client country filters; full description, budget, client stats, proposals, posting time and a direct job URL. Schedule it for alerts. No login. Pay per job.", "version": "0.2", "x-build-id": "5ollcadSGpoKxJInY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapifier~upwork-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapifier-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/scrapifier~upwork-jobs-scraper/runs": { "post": { "operationId": "runs-sync-scrapifier-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/scrapifier~upwork-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-scrapifier-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": { "query": { "title": "Search keywords", "type": "string", "description": "What to search for, as you would type it on Upwork (\"python\", \"react developer\", \"logo design\"). Leave empty to browse the whole feed with the filters below." }, "sort": { "title": "Sort by", "enum": [ "recency", "relevance" ], "type": "string", "description": "\"Most recent first\" is what you want for job alerts and scheduled runs.", "default": "recency" }, "jobType": { "title": "Job type", "enum": [ "", "hourly", "fixed" ], "type": "string", "description": "Hourly or fixed-price. Leave on Any type for both.", "default": "" }, "experienceLevel": { "title": "Experience level", "enum": [ "", "entry", "intermediate", "expert" ], "type": "string", "description": "Required freelancer level on the posting.", "default": "" }, "location": { "title": "Client country", "type": "string", "description": "Full country name as on Upwork (\"United States\", \"France\", \"United Kingdom\"). Two-letter codes like \"US\" return nothing." }, "hourlyRateMin": { "title": "Min hourly rate (USD)", "minimum": 0, "type": "integer", "description": "Only hourly jobs whose budget starts at or above this rate." }, "hourlyRateMax": { "title": "Max hourly rate (USD)", "minimum": 0, "type": "integer", "description": "Only hourly jobs whose budget is at or below this rate." }, "fixedBudgetMin": { "title": "Min fixed budget (USD)", "minimum": 0, "type": "integer", "description": "Only fixed-price jobs at or above this amount." }, "fixedBudgetMax": { "title": "Max fixed budget (USD)", "minimum": 0, "type": "integer", "description": "Only fixed-price jobs at or below this amount." }, "clientHires": { "title": "Client hires", "enum": [ "", "0", "1-9", "10-" ], "type": "string", "description": "How many freelancers the client has already hired on Upwork.", "default": "" }, "contractToHire": { "title": "Contract-to-hire only", "type": "boolean", "description": "Only jobs marked contract-to-hire.", "default": false }, "projectDuration": { "title": "Project duration", "enum": [ "", "week", "month", "semester", "ongoing" ], "type": "string", "description": "Expected project length.", "default": "" }, "workload": { "title": "Workload", "enum": [ "", "as_needed", "part_time", "full_time" ], "type": "string", "description": "Weekly commitment on hourly jobs.", "default": "" }, "timezone": { "title": "Client timezone", "type": "string", "description": "IANA timezone (\"America/New_York\", \"Europe/Paris\"). Empty = any." }, "category": { "title": "Category", "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" ], "type": "string", "description": "Upwork's own top-level category. Pick a name; no id to look up." }, "subcategory": { "title": "Subcategory", "enum": [ "Accounting & Bookkeeping", "Financial Planning", "Management Consulting & Analysis", "Other - Accounting & Consulting", "Personal & Professional Coaching", "Recruiting & Human Resources", "Data Entry & Transcription Services", "Market Research & Product Reviews", "Project Management", "Virtual Assistance", "Community Management & Tagging", "Customer Service & Tech Support", "AI & Machine Learning", "Data Analysis & Testing", "Data Extraction/ETL", "Data Mining & Management", "Art & Illustration", "Audio & Music Production", "Branding & Logo Design", "Graphic, Editorial & Presentation Design", "NFT, AR/VR & Game Art", "Performing Arts", "Photography", "Product Design", "Video & Animation", "3D Modeling & CAD", "Building & Landscape Architecture", "Chemical Engineering", "Civil & Structural Engineering", "Contract Manufacturing", "Electrical & Electronic Engineering", "Energy & Mechanical Engineering", "Interior & Trade Show Design", "Physical Sciences", "Database Management & Administration", "DevOps & Solution Architecture", "ERP/CRM Software", "Information Security & Compliance", "Network & System Administration", "Corporate & Contract Law", "Finance & Tax Law", "International & Immigration Law", "Public Law", "Digital Marketing", "Lead Generation & Telemarketing", "Marketing, PR & Brand Strategy", "Language Tutoring & Interpretation", "Translation & Localization Services", "AI Apps & Integration", "Blockchain, NFT & Cryptocurrency", "Desktop Application Development", "Ecommerce Development", "Game Design & Development", "Mobile Development", "Other - Software Development", "Product Management & Scrum", "QA Testing", "Scripts & Utilities", "Web & Mobile Design", "Web Development", "Content Writing", "Editing & Proofreading Services", "Professional & Business Writing", "Sales & Marketing Copywriting" ], "type": "string", "description": "A subcategory within the category above. Choosing one is enough: its parent category is applied automatically." }, "skill": { "title": "Skill", "type": "string", "description": "A skill tag as Upwork names it, for example \"Figma\", \"Python\", \"Microsoft Excel\" or \"Shopify\". The matching skill is found automatically; if nothing matches, the run continues without this filter and says so in the run's OUTPUT." }, "postedWithin": { "title": "Posted within", "enum": [ "0", "1", "3", "7", "14", "30" ], "type": "string", "description": "Keep jobs published inside this window. Applied after fetch; with \"Most recent first\" the run stops once jobs are older than the window.", "default": "0" }, "startUrls": { "title": "Upwork search URLs", "type": "array", "description": "Optional: paste full Upwork job-search URLs (https://www.upwork.com/nx/search/jobs/?q=python&sort=recency). Each URL is scraped with its own filters, in addition to the keyword search above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxJobs": { "title": "Maximum jobs", "minimum": 0, "type": "integer", "description": "Stop after this many new jobs in total — the number of results you pay for. Set 0 for no limit: every unique job the search returns (broad searches are continued past one result window (~5,050) by splitting on type, client hires, experience and rate — this can collect thousands of results).", "default": 0 }, "incrementalMode": { "title": "Only new jobs since last run", "type": "boolean", "description": "Remember job ids already returned for this search and only push listings that are new. Turn this on for scheduled alerts.", "default": false }, "fullDescription": { "title": "Fetch full job descriptions", "type": "boolean", "description": "Keep each job's complete description. Off = omit the description; listing metadata is unchanged.", "default": true }, "flatten": { "title": "Flatten output (CSV / Excel friendly)", "type": "boolean", "description": "Join the skills list into a comma-separated string so every column stays flat.", "default": false }, "emitInputStatus": { "title": "Report input status", "type": "boolean", "description": "Write an input_status report to the run's OUTPUT record (how many jobs each search collected and why it stopped).", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Keep Apify Proxy on. A residential proxy gives the most reliable cloud runs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }