# Upwork Talent Scraper — Freelancers, Rates & Earnings (`bovi/upwork-talent-scraper`) Actor Scrape public Upwork freelancer profiles into clean JSON: name, title, hourly rate, EXACT lifetime earnings, total hours, hourly/fixed job split, top-rated flags, granular location, and skills. Search by keyword, no login or API key. - **URL**: https://apify.com/bovi/upwork-talent-scraper.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** Lead generation, Business - **Stats:** 4 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $19.00 / 1,000 freelancer profiles This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Upwork Talent Scraper — Freelancers, Rates & Earnings Turn Upwork's public talent directory into clean, analysis-ready JSON. Search by keyword (or paste a filtered search URL) and get **one structured record per freelancer** — name, title, hourly rate, **exact lifetime earnings**, total hours, the hourly-vs-fixed job split, top-rated status, granular location, and a clean skills array. No login, no cookies, no API key. This actor reads only the **public, logged-out** Upwork talent-search page — the same page any visitor sees — and parses the data Upwork itself ships in that page. It does not log in, solve a paywall, or touch private data. --- ### Why this scraper Most Upwork talent scrapers fall into one of two traps, and we fixed both: - **The "rich but wrong" trap.** Some scrapers expose lots of fields but get the important numbers wrong — returning `0` lifetime earnings for clearly established, top-rated freelancers, or a broken job-success value. A market or rate analysis built on those numbers is quietly corrupted. - **The "clean but thin" trap.** Others return correct values but only coarse buckets — a `"$400K+ earned"` string instead of a number, a single `"Philippines"` location string with no city or timezone, and no job-type split. **This actor ships the precise figure** — `total_earnings_usd` is the exact number Upwork serves (e.g. `179240.68`), not a bucket and not a zero — **plus** granular location (country / state / city / region / timezone) and the hourly/fixed/completed job-count split. Numbers you can actually sort, filter, and model on. --- ### What you get — output fields One row per freelancer: | Field | Description | |---|---| | `freelancer_id`, `ciphertext`, `profile_url` | Stable identity + public profile link | | `title`, `first_name`, `last_name`, `short_name`, `description` | Headline + bio | | `hourly_rate_usd`, `currency` | Listed hourly rate | | **`total_earnings_usd`** | **Exact lifetime earnings (the precise number, not a bucket)** | | `earnings_hidden` | `true` if the freelancer hides earnings (then the figure is withheld by Upwork) | | `total_hours` | Lifetime tracked hours | | `total_hourly_jobs`, `total_fixed_jobs`, `total_completed_jobs` | Job-count split | | `job_success_flag` | Coarse job-success flag as shipped in the search payload (1/0, not a precise %) | | `is_top_rated`, `is_top_rated_plus`, `top_rated_status` | Reputation badges | | `country`, `state`, `city`, `region`, `subregion`, `timezone` | Granular location | | `skills`, `skills_count` | Clean skill names (e.g. `"Data Scraping"`, not a slug) | | `total_portfolio_items` | Portfolio size | | `offers_consultations`, `is_diversity_certified` | Profile flags | | `portrait_url` | Avatar image URL | | `search_query`, `search_rank` | Which query surfaced this profile, and its position | | `scraped_at` | UTC timestamp | > **Honesty note on job-success:** Upwork's public search payload exposes > job-success only as a coarse flag, not the precise 0–100 Job Success Score > shown on the full profile page. We surface it as `job_success_flag` and never > dress it up as a percentage. The headline reputation signals you *can* trust > here are the exact earnings, hours, job counts, and the top-rated badges. --- ### Input | Input | Description | |---|---| | `searchQueries` | List of keywords, e.g. `"python developer"`, `"shopify expert"`. Each is searched and paginated. | | `searchUrls` | Optional. Full talent-search URLs from the Upwork UI (with your skill/location/rate filters). Pagination is automatic. | | `maxProfiles` | Ceiling on total freelancers returned (cost safety). Default 50. Upwork returns 10 per page. | | `country` | Two-letter managed-access exit country. Default `us`. | Provide keywords, URLs, or both. Example: ```json { "searchQueries": ["python developer", "react developer"], "maxProfiles": 100 } ```` *** ### Pricing This actor is **pay-per-result**: you are charged once per `profile-result` (one freelancer record). You only pay for the freelancers actually returned. The managed-access layer that reaches Upwork reliably is included in the price — you supply no proxy and no external key. `maxProfiles` is a hard ceiling, so your spend is always bounded by the number of results you ask for. *** ### Use cases - **Rate & market intelligence.** "What do top-rated Python developers actually charge, and how much have they earned?" Sort by exact earnings and rate to benchmark a skill's market. - **Recruiting / sourcing.** Build a shortlist of freelancers for a skill, filtered by location/timezone for overlap with your team, ranked by hours and job count. - **Agency competitive analysis.** Track which freelancers in your niche are winning the most work and at what rates. - **Talent-supply signals.** Feed a dataset of available freelancers per skill into your own pricing or staffing model. *** ### How it works Upwork's talent-search page renders its data into an embedded state blob. This actor reaches the public page through a **managed-access service** (the top rung of our access ladder, included as our cost — you pay nothing extra), parses the embedded freelancer state with a real JavaScript engine, and emits one clean, flat row per freelancer. A managed-access browser is used as an automatic fallback if the request path is ever challenged. *** ### Notes & limitations - Only **public** profile data that Upwork serves to logged-out visitors is returned. No private contact details, no login-gated fields. - Freelancers who hide their earnings or job-success on Upwork will have those fields returned empty (`earnings_hidden: true`) — we never fabricate a value. - Upwork shows up to ~1,000 pages of results per query; very deep pagination is bounded by `maxProfiles`. - Field availability follows what Upwork exposes; if Upwork changes its page, the parser is built on structure (not brittle CSS class names) to stay resilient. *** ### Legal This actor collects only publicly available information from Upwork's logged-out talent-search pages. You are responsible for using the data in compliance with Upwork's terms and all applicable laws (including data-protection rules such as GDPR/CCPA where relevant). Do not use the data for spam or unlawful profiling. # Actor input Schema ## `searchQueries` (type: `array`): Keywords to search Upwork's public talent directory, e.g. 'python developer', 'react developer', 'shopify expert'. Each keyword is searched and paginated, returning one record per freelancer found (name, title, hourly rate, EXACT lifetime earnings, hours, job counts, top-rated flags, granular location, skills). ## `searchUrls` (type: `array`): Optional. Full Upwork talent-search URLs for power users who built a filtered search in the UI (skills, location, rate, category filters). Paste the URL from the address bar, e.g. https://www.upwork.com/nx/search/talent/?q=python\&hourly\_rate=20-50. Pagination is handled automatically. Use this OR keywords (or both). ## `maxProfiles` (type: `integer`): Maximum number of freelancer records to return across all queries. Acts as a safety ceiling on cost. Upwork returns 10 freelancers per page. ## `country` (type: `string`): Two-letter country code for the managed-access exit (default 'us'). Upwork talent pages render best from a US exit. ## `proxyConfiguration` (type: `object`): Optional. This actor routes through a managed-access layer that handles Upwork reliably, so no proxy is required. The field is shown for compatibility and is otherwise ignored. ## Actor input object example ```json { "searchQueries": [ "python developer" ], "searchUrls": [], "maxProfiles": 50, "country": "us" } ``` # Actor output Schema ## `results` (type: `string`): Dataset of freelancer records (short\_name, title, hourly\_rate\_usd, total\_earnings\_usd, total\_hours, total\_hourly\_jobs, total\_fixed\_jobs, job\_success\_flag, is\_top\_rated, country, city, timezone, skills, profile\_url, search\_query, scraped\_at). # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "python developer" ], "searchUrls": [] }; // Run the Actor and wait for it to finish const run = await client.actor("bovi/upwork-talent-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": ["python developer"], "searchUrls": [], } # Run the Actor and wait for it to finish run = client.actor("bovi/upwork-talent-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQueries": [ "python developer" ], "searchUrls": [] }' | apify call bovi/upwork-talent-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/upwork-talent-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Upwork Talent Scraper — Freelancers, Rates & Earnings", "description": "Scrape public Upwork freelancer profiles into clean JSON: name, title, hourly rate, EXACT lifetime earnings, total hours, hourly/fixed job split, top-rated flags, granular location, and skills. Search by keyword, no login or API key.", "version": "0.1", "x-build-id": "iwwUv6gJZsWSe70ig" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~upwork-talent-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-upwork-talent-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/bovi~upwork-talent-scraper/runs": { "post": { "operationId": "runs-sync-bovi-upwork-talent-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/bovi~upwork-talent-scraper/run-sync": { "post": { "operationId": "run-sync-bovi-upwork-talent-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": { "searchQueries": { "title": "Search keywords", "type": "array", "description": "Keywords to search Upwork's public talent directory, e.g. 'python developer', 'react developer', 'shopify expert'. Each keyword is searched and paginated, returning one record per freelancer found (name, title, hourly rate, EXACT lifetime earnings, hours, job counts, top-rated flags, granular location, skills).", "items": { "type": "string" } }, "searchUrls": { "title": "Talent-search URLs (optional)", "type": "array", "description": "Optional. Full Upwork talent-search URLs for power users who built a filtered search in the UI (skills, location, rate, category filters). Paste the URL from the address bar, e.g. https://www.upwork.com/nx/search/talent/?q=python&hourly_rate=20-50. Pagination is handled automatically. Use this OR keywords (or both).", "items": { "type": "string" } }, "maxProfiles": { "title": "Max freelancers", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of freelancer records to return across all queries. Acts as a safety ceiling on cost. Upwork returns 10 freelancers per page.", "default": 50 }, "country": { "title": "Managed-access exit country", "type": "string", "description": "Two-letter country code for the managed-access exit (default 'us'). Upwork talent pages render best from a US exit.", "default": "us" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. This actor routes through a managed-access layer that handles Upwork reliably, so no proxy is required. The field is shown for compatibility and is otherwise ignored." } } }, "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 } } } } } } } } } } ```