{ "openapi": "3.0.1", "info": { "title": "Upwork Freelance Jobs & Projects Scraper", "description": "Fast, high-yield HTTP-only scraper for Upwork job postings and freelance projects. Extracts job titles, full descriptions, budget, hourly rates, client intelligence (country, feedback, total spent, hires count), required skills, duration, and proposal counts with zero browser overhead.", "version": "1.0", "x-build-id": "64dfMqyDovJZgXra6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/wyle~upwork-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-wyle-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/wyle~upwork-jobs-scraper/runs": { "post": { "operationId": "runs-sync-wyle-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/wyle~upwork-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-wyle-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": { "queries": { "title": "Search Queries", "type": "array", "description": "List of keywords or job titles to search on Upwork (e.g. 'python', 'ai agent', 'web scraping', 'react').", "default": [ "python" ] }, "sort": { "title": "Sort By", "enum": [ "recency", "relevance" ], "type": "string", "description": "Order of job results.", "default": "recency" }, "jobType": { "title": "Job Type", "enum": [ "all", "hourly", "fixed" ], "type": "string", "description": "Filter by hourly contracts, fixed-price contracts, or both.", "default": "all" }, "hourlyMin": { "title": "Hourly Min Rate ($/hr)", "type": "integer", "description": "Minimum hourly rate filter (in USD)." }, "hourlyMax": { "title": "Hourly Max Rate ($/hr)", "type": "integer", "description": "Maximum hourly rate filter (in USD)." }, "fixedMin": { "title": "Fixed Min Price ($)", "type": "integer", "description": "Minimum fixed budget filter (in USD)." }, "fixedMax": { "title": "Fixed Max Price ($)", "type": "integer", "description": "Maximum fixed budget filter (in USD)." }, "experienceLevel": { "title": "Experience Level", "type": "array", "description": "Filter by required experience levels.", "items": { "type": "string", "enum": [ "entry", "intermediate", "expert" ], "enumTitles": [ "Entry Level", "Intermediate", "Expert" ] } }, "paymentVerifiedOnly": { "title": "Payment Verified Only", "type": "boolean", "description": "Only return jobs from clients with verified payment methods.", "default": false }, "clientCountries": { "title": "Client Countries", "type": "array", "description": "Filter jobs by client location (e.g., 'United States', 'United Kingdom', 'Canada')." }, "directUrls": { "title": "Direct Search URLs", "type": "array", "description": "Direct Upwork search URLs (e.g. 'https://www.upwork.com/nx/search/jobs/?q=python&sort=recency')." }, "masterAccessToken": { "title": "Master Access Token (Optional)", "type": "string", "description": "Optional Upwork 'master_access_token' cookie or Bearer token for direct high-speed GraphQL querying." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of job postings to scrape and push to the dataset.", "default": 50 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. For Upwork Cloudflare WAF bypass, Apify Residential Proxy (US) is strongly recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } }, "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 } } } } } } } } } }