{ "openapi": "3.0.1", "info": { "title": "Upwork Freelancers Scraper - Hourly Rate & Earnings", "description": "Scrapes Upwork freelancer profiles by skill keyword. Returns a flat row with title, hourly rate, total earnings, job success score, and location.", "version": "1.0", "x-build-id": "zkZsS605TxNxRoy8e" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~upwork-freelancers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-upwork-freelancers-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-freelancers-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-upwork-freelancers-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-freelancers-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-upwork-freelancers-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": { "searchUrl": { "title": "Upwork search URL", "type": "string", "description": "Paste the address of a talent search on upwork.com (for example https://www.upwork.com/nx/search/talent/?q=copywriting&loc=united-states&revenue=0). Its keyword, location, earned amount, hourly rate, job success, hours billed and badge filters replace the matching fields below. Filters that need an Upwork login, such as English level, are skipped and listed in the log. A single freelancer's profile address (upwork.com/freelancers/~01...) is not a search: the run reports it and uses the keyword below instead." }, "searchQuery": { "title": "Skill or job title keyword", "type": "string", "description": "Search keyword for finding freelancers (e.g. 'python developer', 'web scraping', 'react'). Several keywords separated by commas run as separate searches and the results are merged, with each freelancer returned once." }, "maxItems": { "title": "Maximum freelancers", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "How many freelancers to collect per run." }, "skipPreviouslyScraped": { "title": "Skip freelancers from earlier runs", "type": "boolean", "description": "Remember every freelancer this actor delivers and leave them out of later runs, so running the same search again returns only new profiles. You are charged only for the new ones. The history is kept in a key-value store in your Apify account under the name below.", "default": false }, "historyName": { "title": "History name", "type": "string", "description": "Name of the key-value store that holds the history (letters, digits and hyphens). Runs that share a name never return the same freelancer twice, even across different searches. Use a separate name per campaign, or delete the store in Storage to start over." }, "earnings": { "title": "Earned amount", "enum": [ "", "none", "1", "100", "1000", "10000" ], "type": "string", "description": "Keep only freelancers in this earnings bracket. 'No earnings yet' finds new freelancers who have not been paid on Upwork. Upwork does not filter by earnings for visitors, so the actor reads the results in order and keeps the matches: narrow searches finish faster.", "default": "" }, "hourlyRateMin": { "title": "Minimum hourly rate (USD)", "minimum": 0, "type": "integer", "description": "Only freelancers charging at least this hourly rate." }, "hourlyRateMax": { "title": "Maximum hourly rate (USD)", "minimum": 0, "type": "integer", "description": "Only freelancers charging at most this hourly rate." }, "jobSuccessMin": { "title": "Minimum job success score (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only freelancers with at least this Job Success Score, from 0 to 100." }, "hoursMin": { "title": "Minimum hours billed", "minimum": 0, "type": "integer", "description": "Only freelancers who billed at least this many hours on Upwork." }, "topRatedOnly": { "title": "Top Rated Only", "type": "boolean", "description": "Only show Top Rated and Top Rated Plus freelancers", "default": false }, "topRatedPlusOnly": { "title": "Top Rated Plus Only", "type": "boolean", "description": "Only show Top Rated Plus freelancers", "default": false }, "risingTalentOnly": { "title": "Rising Talent Only", "type": "boolean", "description": "Only show freelancers with the Rising Talent badge", "default": false }, "usOnly": { "title": "US Only", "type": "boolean", "description": "Only show freelancers from the United States. Ignored when region, sub-region, or country is set.", "default": false }, "region": { "title": "Region", "enum": [ "", "Africa", "Americas", "Asia", "Europe", "Oceania" ], "type": "string", "description": "Filter by continent. Only one location filter can be used at a time (region, sub-region, or country). Overrides 'US Only'." }, "subRegion": { "title": "Sub-region", "enum": [ "", "Eastern Europe", "Western Europe", "Latin America", "Middle East", "North America" ], "type": "string", "description": "Filter by sub-region. Only one location filter can be used at a time (region, sub-region, or country). Overrides 'US Only'." }, "country": { "title": "Country", "enum": [ "", "Afghanistan", "Albania", "Algeria", "Andorra", "Angola", "Antigua and Barbuda", "Argentina", "Armenia", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Brazil", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Central African Republic", "Chad", "Chile", "China", "Colombia", "Comoros", "Congo", "Costa Rica", "Croatia", "Cyprus", "Czech Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Fiji", "Finland", "France", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Greece", "Grenada", "Guatemala", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iraq", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Mauritania", "Mauritius", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "New Zealand", "Nicaragua", "Niger", "Nigeria", "North Macedonia", "Norway", "Oman", "Pakistan", "Palau", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russia", "Rwanda", "Saint Kitts and Nevis", "Saint Lucia", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Korea", "Spain", "Sri Lanka", "Sudan", "Suriname", "Sweden", "Switzerland", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Togo", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Vietnam", "Yemen", "Zambia", "Zimbabwe" ], "type": "string", "description": "Filter by specific country. Only one location filter can be used at a time (region, sub-region, or country). Overrides 'US Only'." } } }, "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 } } } } } } } } } }