# Freelancer.com Freelancer Scraper | Enterprise Grade (`fatihtahta/freelancer-com-scraper`) Actor Extract structured Freelancer.com freelancer profiles with hourly rates, earnings, skills, portfolios, reviews, reputation signals and more. Built for enterprise-grade talent sourcing, marketplace intelligence, lead enrichment, and automated recruiting or analytics pipelines. - **URL**: https://apify.com/fatihtahta/freelancer-com-scraper.md - **Developed by:** [Fatih Tahta](https://apify.com/fatihtahta) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $0.99 / 1,000 standard results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## Freelancer.com Freelancer Scraper **Slug:** fatihtahta/freelancer-com-scraper ### Overview Freelancer.com Freelancer Scraper collects structured freelancer profile data from Freelancer.com, including profile identifiers, names, usernames, locations, hourly rates, ratings, review counts, earnings signals, skills, portfolios, and public reputation metadata. It can also return richer public profile details such as job reputation, exams, SEO profile snippets, rating breakdowns, and an extended profile object when those attributes are available. When review collection is enabled, it also fetches public freelancer review records from Freelancer's review API and saves each review as its own dataset item linked back to the freelancer. [Freelancer.com](https://www.freelancer.com) is a global freelance marketplace, and its public freelancer directory data is useful for sourcing, enrichment, benchmarking, and market analysis. This actor automates repetitive collection work and returns consistent JSON records that are easier to use in spreadsheets, dashboards, and pipelines. It saves time, reduces manual copy-paste work, and makes recurring data collection more dependable. ### Why Use This Actor - **Market research and analytics:** Track freelancer supply, rates, skills, ratings, and geography across categories to benchmark markets and monitor changes over time. - **Product and content teams:** Study how freelancers describe services, position expertise, and present portfolios to inform messaging, landing pages, and editorial planning. - **Developers and data engineering pipelines:** Feed structured freelancer records into ETL jobs, warehouses, dashboards, search indexes, and downstream APIs. - **Lead generation and enrichment:** Build targeted prospect lists and enrich vendor or freelancer databases with profile details, service signals, and public reputation metrics. - **Monitoring and competitive tracking:** Re-run the same searches on a schedule to watch changes in pricing, visibility, reviews, skills, and profile quality signals. ### Input Parameters Provide any combination of URLs, queries, and filters... | Parameter | Type | Description | Default | | --- | --- | --- | --- | | `enrich_data` | `boolean` | When enabled, adds richer public profile details when available, such as extended profile metadata, portfolio counts, images, registration date, timezone data, and additional public profile attributes. | `false` | | `get_reviews` | `boolean` | When enabled, fetches public review records for each saved freelancer from the Freelancer reviews API and stores them as separate dataset records linked to that freelancer. | `false` | | `max_reviews` | `integer` | Maximum number of review records to save per freelancer profile when `get_reviews` is enabled. This is a per-freelancer cap, not a run-wide cap. Leave empty to keep all available reviews. | `-` | | `queries` | `array[string]` | Words or phrases to search on Freelancer.com. Use skills, roles, services, or names such as `php developer`, `ux designer`, or `john smith`. | `-` | | `hourly_rate` | `string` | Optional hourly-rate filter for query-based discovery. Allowed values: `<$10/hour`, `$10-$20/hour`, `$20-$30/hour`, `$30-$40/hour`, `>$40/hour`. | `-` | | `country` | `string` | Optional country filter. Allowed values: one supported country from the actor input, including `United States`, `United Kingdom`, `India`, `Canada`, `Germany`, `Australia`, and many others. | `-` | | `min_rating` | `string` | Optional minimum public rating threshold. Allowed values: `1 star and up`, `2 star and up`, `3 star and up`, `4 star and up`, `5 star`. | `-` | | `currently_online` | `boolean` | When enabled, limits results to freelancers who appear online at the time of collection. | `false` | | `category` | `string` | Optional service-category filter. Allowed values include `build-a-website`, `write-some-software`, `content-writing`, `design-a-logo`, `social-media-marketing`, `help-with-crm`, `general-labour`, and the other supported category values available in the actor input. | `-` | | `limit` | `integer` | Maximum number of results to save for each search term or starting input. Leave empty to collect as many matching results as are available. | `-` | | `proxyConfiguration` | `object` | Optional Apify or custom proxy settings for more reliable collection on larger or repeated runs. | Apify proxy with `RESIDENTIAL` group | ### Example Inputs Scenario: Search-driven run ```json { "queries": ["react developer", "next.js developer"], "country": "India", "hourly_rate": "$20-$30/hour", "min_rating": "4 star and up", "category": "write-some-software", "limit": 200 } ```` Scenario: Direct URL run ```json { "startUrls": [ "https://www.freelancer.com/freelancers", "https://www.freelancer.com/freelancers/united-states/design-a-logo" ], "country": "United States", "min_rating": "4 star and up", "currently_online": true, "limit": 150 } ``` Scenario: Filtered and enriched run ```json { "queries": ["seo specialist"], "country": "United Kingdom", "hourly_rate": "$10-$20/hour", "min_rating": "5 star", "currently_online": true, "category": "seo-my-website", "enrich_data": true, "get_reviews": true, "max_reviews": 50, "limit": 100 } ``` ### Output #### 6.1 Output destination The actor writes results to an Apify dataset as JSON records. And the dataset is designed for direct consumption by analytics tools, ETL pipelines, and downstream APIs without post-processing. #### 6.2 Record envelope (all items) - **type** *(string, required)*: Record category. This actor currently emits `profile`, `review`, and summary/debug records. - **id** *(number, required)*: Freelancer.com profile identifier. - **url** *(string, required)*: Canonical Freelancer.com profile URL. Recommended idempotency key: `type + ":" + id` Use this key to deduplicate repeated discoveries and to upsert the same freelancer deterministically across recurring runs. #### 6.3 Examples Example: profile (`type = "profile"`) ```json { "type": "profile", "id": 24288455, "url": "https://www.freelancer.com/u/BrightDock", "title": "BrightDock LLC", "publicName": "BrightDock LLC", "sourceUrl": "https://www.freelancer.com/freelancers?freeSearch=bright", "seedId": "98d6f0e364d1", "seedType": "query", "seedValue": "bright", "pageIndex": 1, "username": "BrightDock", "description": "BrightDock helps business leaders develop successful digital products.", "location": "Rijeka / Croatia", "country": "Croatia", "city": "Rijeka", "tagline": "Bio For More - #1 Ranked In Freelancer.com Search.", "price": "EUR 95 / hour", "priceNumeric": 95, "currency": "EUR", "hourlyRate": 95, "rating": 4.993173009582965, "reviewsCount": 227, "totalEarnings": 1473874, "skills": [ "PHP", "Java", "JavaScript", "Python", "Website Design" ], "topSkills": [ { "skillId": "3", "name": "PHP", "categoryId": "1", "earnings": 905434.7502185, "seoUrl": "php" } ], "skillDetails": [ { "skillId": 395, "name": "3D Animation", "isUserSkill": true, "repScore": 74, "skillJobCount": 1 } ], "exams": [ { "examId": "218", "examName": "Semiconductor Electronics", "scorePercentage": 82 } ], "seoProfiles": [ { "jobIds": ["357"], "headline": "Professional Website Designer", "seoText": "Professional website designer with development and digital marketing experience." } ], "portfolios": [ { "title": "Huuk | Marketing Campaign", "description": "Branding, product, and campaign work for a social media application." } ], "reviewJobTitles": [ "Build a website", "Frontend Developer" ], "jobReputation": [ { "jobId": "3", "jobName": "PHP", "score": 5950, "stars": 5.0000001 } ], "geoLocation": { "lat": 45.327, "lon": 14.442 }, "ratingBreakdown": { "quality": 4.99806631975284, "communication": 4.970309120061813, "expertise": 4.999423288347337, "professionalism": 5, "hireAgain": 4.99806631975284, "onBudget": 0.9986364745332539, "onTime": 0.9711507554071165, "positive": 0.031244201888307038, "overall": 4.993173009582965 }, "reviewStats": { "all": 246, "reviews": 227, "incompleteReviews": 2, "complete": 244, "incomplete": 2, "earnings": 1473874, "completionRate": 0.991869918699187 }, "insigniaIds": [102, 145, 169, 690, 694, 701], "poolIds": [1, 3, 17], "freelancerReputation": 4.1393339671874925, "freelancerReputationVariant": 4.904553184919854, "score": 11308, "stars": 5.0000001, "hidden": false, "isOnline": false, "invited": false, "isSponsored": false, "isHighlighted": false, "membershipBadge": "plus", "logoUrl": "https://cdn6.f-cdn.com/ppic/293850094/logo/24288455/profile_logo_24288455.jpg", "profileLogoUrl": "https://cdn3.f-cdn.com/ppic/293850093/logo/24288455/VIKvS/profile_logo_KGFPU_98ae5805fe4ef7d75e007132b8deb624.jpeg", "registrationDate": 1490726779, "coverImage": { "current_image": { "id": 206747, "url": "https://cdn6.f-cdn.com/files/download/206409018/c0b1c2.jpg", "width": 1920, "height": 550 } }, "portfolioCount": 86, "timezone": { "id": 292, "country": "HR", "timezone": "Europe/Zagreb", "offset": 2 }, "profileDetails": { "id": 24288455, "username": "BrightDock", "display_name": "BrightDock LLC", "public_name": "BrightDock LLC", "profile_description": "BrightDock helps business leaders develop successful digital products.", "hourly_rate": 95, "registration_date": 1490726779, "role": "freelancer", "preferred_freelancer": true, "location": { "country": { "name": "Croatia", "code": "hr" }, "city": "Rijeka", "latitude": 45.327, "longitude": 14.442 }, "status": { "payment_verified": true, "email_verified": true, "phone_verified": true, "identity_verified": true, "profile_complete": true }, "primary_currency": { "id": 8, "code": "EUR", "sign": "EUR", "name": "Euro" }, "membership_package": { "id": 18, "name": "plus" }, "jobs": [ { "id": 3, "name": "PHP", "seo_url": "php" } ], "qualifications": [ { "id": 533, "name": "Preferred Freelancer Program SLA Exam", "score_percentage": 84 } ], "badges": [ { "id": 31, "name": "All Star" } ] }, "fingerprint": "f5f3da873a204f36ee7a" } ``` Example: review (`type = "review"`) ```json { "type": "review", "reviewId": 21981776, "sourceUrl": "https://www.freelancer.com/freelancers?freeSearch=bright", "seedId": "98d6f0e364d1", "seedType": "query", "seedValue": "bright", "pageIndex": 1, "freelancerId": "24288455", "freelancerTitle": "BrightDock LLC", "freelancerPublicName": "BrightDock LLC", "freelancerUsername": "BrightDock", "freelancerUrl": "https://www.freelancer.com/u/BrightDock", "projectId": 40256218, "toUserId": 24288455, "fromUserId": 90996999, "role": "freelancer", "status": "active", "timeSubmitted": 1773327662, "description": "Very attentive and professional with great resources and project management. Will use again.", "submitDate": 1773327662, "rating": 5, "reviewProjectStatus": "complete", "ratingDetails": { "category_ratings": { "hire_again": 5, "quality": 5, "communication": 5, "expertise": 5, "professionalism": 5 } }, "reviewContext": { "review_type": "project", "context_id": 40256218, "context_name": "Resource Download Tracking System" }, "projectDetails": { "id": 40256218, "title": "Resource Download Tracking System" } } ``` ### Field reference #### Profile fields (`type = "profile"`) - **type** *(string, required)*: Record category. - **id** *(number, required)*: Freelancer profile identifier. - **url** *(string, required)*: Canonical profile URL. - **title** *(string, required)*: Primary public title or display label. - **publicName** *(string, optional)*: Public-facing profile name. - **sourceUrl** *(string, optional)*: Search or directory URL where the record was found. - **seedId** *(string, optional)*: Stable identifier for the originating input. - **seedType** *(string, optional)*: Input type, such as `query` or `url`. - **seedValue** *(string, optional)*: Original query or seed value. - **pageIndex** *(integer, optional)*: Result page where the profile was discovered. - **username** *(string, optional)*: Freelancer username. - **description** *(string, optional)*: Public profile summary. - **location** *(string, optional)*: Display-ready location string. - **country** *(string, optional)*: Country name. - **city** *(string, optional)*: City name. - **tagline** *(string, optional)*: Short public tagline. - **price** *(string, optional)*: Hourly rate as displayed. - **priceNumeric** *(number, optional)*: Parsed numeric rate value. - **currency** *(string, optional)*: Currency code or symbol context for the rate. - **hourlyRate** *(number, optional)*: Numeric hourly rate. - **rating** *(number, optional)*: Overall public rating. - **reviewsCount** *(integer, optional)*: Public review count. - **totalEarnings** *(number, optional)*: Reported lifetime earnings. - **skills** *(array\[string], optional)*: Visible skills list. - **topSkills** *(array\[object], optional)*: Summary of top skills. - **topSkills\[].skillId** *(string, optional)*: Skill identifier. - **topSkills\[].name** *(string, required)*: Skill name. - **topSkills\[].categoryId** *(string, optional)*: Skill category identifier. - **topSkills\[].earnings** *(number, optional)*: Earnings attributed to that skill when available. - **topSkills\[].seoUrl** *(string, optional)*: Skill slug. - **skillDetails** *(array\[object], optional)*: Detailed skill metadata. - **skillDetails\[].skillId** *(integer, required)*: Skill identifier. - **skillDetails\[].name** *(string, required)*: Skill name. - **skillDetails\[].isUserSkill** *(boolean, optional)*: Whether the skill is marked on the profile. - **skillDetails\[].repScore** *(integer, optional)*: Skill reputation score. - **skillDetails\[].skillJobCount** *(integer, optional)*: Number of jobs linked to the skill. - **exams** *(array\[object], optional)*: Public exam summaries. - **exams\[].examId** *(string, required)*: Exam identifier. - **exams\[].examName** *(string, optional)*: Exam name. - **exams\[].scorePercentage** *(integer, optional)*: Exam score percentage. - **seoProfiles** *(array\[object], optional)*: SEO profile snippets when available. - **seoProfiles\[].jobIds** *(array\[string], optional)*: Related job identifiers. - **seoProfiles\[].headline** *(string, optional)*: Public SEO headline text. - **seoProfiles\[].seoText** *(string, optional)*: Public SEO summary text. - **portfolios** *(array\[object], optional)*: Portfolio items. - **portfolios\[].title** *(string, required)*: Portfolio title. - **portfolios\[].description** *(string, optional)*: Portfolio description. - **reviewJobTitles** *(array\[string], optional)*: Job titles associated with public review history. - **jobReputation** *(array\[object], optional)*: Per-job reputation summary. - **jobReputation\[].jobId** *(string, required)*: Job identifier. - **jobReputation\[].jobName** *(string, optional)*: Job name. - **jobReputation\[].score** *(integer, optional)*: Reputation score for the job. - **jobReputation\[].stars** *(number, optional)*: Star rating for the job. - **geoLocation** *(object, optional)*: Geographic coordinates. - **geoLocation.lat** *(number, optional)*: Latitude. - **geoLocation.lon** *(number, optional)*: Longitude. - **ratingBreakdown** *(object, optional)*: Detailed public rating components. - **ratingBreakdown.quality** *(number, optional)*: Quality score. - **ratingBreakdown.communication** *(number, optional)*: Communication score. - **ratingBreakdown.expertise** *(number, optional)*: Expertise score. - **ratingBreakdown.professionalism** *(number, optional)*: Professionalism score. - **ratingBreakdown.hireAgain** *(number, optional)*: Hire-again score. - **ratingBreakdown.onBudget** *(number, optional)*: On-budget score. - **ratingBreakdown.onTime** *(number, optional)*: On-time score. - **ratingBreakdown.positive** *(number, optional)*: Positive-feedback share. - **ratingBreakdown.overall** *(number, optional)*: Overall score. - **reviewStats** *(object, optional)*: Aggregated review statistics. - **reviewStats.all** *(integer, optional)*: Total feedback entries. - **reviewStats.reviews** *(integer, optional)*: Completed reviews. - **reviewStats.incompleteReviews** *(integer, optional)*: Incomplete review count. - **reviewStats.complete** *(integer, optional)*: Completed contracts. - **reviewStats.incomplete** *(integer, optional)*: Incomplete contracts. - **reviewStats.earnings** *(number, optional)*: Earnings total in review statistics. - **reviewStats.completionRate** *(number, optional)*: Completion rate. - **insigniaIds** *(array\[integer], optional)*: Public insignia identifiers. - **poolIds** *(array\[integer], optional)*: Public pool identifiers. - **freelancerReputation** *(number, optional)*: Reputation score. - **freelancerReputationVariant** *(number, optional)*: Alternate reputation score variant. - **score** *(integer, optional)*: Aggregate profile score. - **stars** *(number, optional)*: Public star rating value. - **hidden** *(boolean, optional)*: Hidden-status flag. - **isOnline** *(boolean, optional)*: Online-status flag. - **invited** *(boolean, optional)*: Invitation-status flag. - **isSponsored** *(boolean, optional)*: Sponsored-listing flag. - **isHighlighted** *(boolean, optional)*: Highlighted-listing flag. - **membershipBadge** *(string, optional)*: Membership badge label shown on the listing. - **logoUrl** *(string, optional)*: Logo image URL. - **profileLogoUrl** *(string, optional)*: Profile image URL. - **registrationDate** *(integer, optional)*: Registration timestamp when extended profile data is available. - **coverImage** *(object, optional)*: Public cover-image object when available. - **coverImage.current\_image.id** *(integer, optional)*: Cover image identifier. - **coverImage.current\_image.url** *(string, optional)*: Cover image URL. - **coverImage.current\_image.width** *(integer, optional)*: Cover image width. - **coverImage.current\_image.height** *(integer, optional)*: Cover image height. - **portfolioCount** *(integer, optional)*: Number of portfolio items reported by the extended profile. - **timezone** *(object, optional)*: Public timezone metadata when available. - **timezone.id** *(integer, optional)*: Timezone identifier. - **timezone.country** *(string, optional)*: Country code tied to the timezone. - **timezone.timezone** *(string, optional)*: IANA timezone name. - **timezone.offset** *(number, optional)*: UTC offset. - **profileDetails** *(object, optional)*: Extended public profile object when available. - **profileDetails.id** *(number, optional)*: Profile identifier inside the extended object. - **profileDetails.username** *(string, optional)*: Username inside the extended object. - **profileDetails.display\_name** *(string, optional)*: Display name inside the extended object. - **profileDetails.public\_name** *(string, optional)*: Public company or profile name. - **profileDetails.profile\_description** *(string, optional)*: Extended profile description. - **profileDetails.hourly\_rate** *(number, optional)*: Hourly rate in the extended object. - **profileDetails.registration\_date** *(integer, optional)*: Registration timestamp. - **profileDetails.role** *(string, optional)*: Public role label. - **profileDetails.preferred\_freelancer** *(boolean, optional)*: Preferred Freelancer status when present. - **profileDetails.location.country.name** *(string, optional)*: Country name. - **profileDetails.location.country.code** *(string, optional)*: Country code. - **profileDetails.location.city** *(string, optional)*: City name. - **profileDetails.location.latitude** *(number, optional)*: Latitude. - **profileDetails.location.longitude** *(number, optional)*: Longitude. - **profileDetails.status.payment\_verified** *(boolean, optional)*: Payment verification flag. - **profileDetails.status.email\_verified** *(boolean, optional)*: Email verification flag. - **profileDetails.status.phone\_verified** *(boolean, optional)*: Phone verification flag. - **profileDetails.status.identity\_verified** *(boolean, optional)*: Identity verification flag. - **profileDetails.status.profile\_complete** *(boolean, optional)*: Profile-complete flag. - **profileDetails.primary\_currency.id** *(integer, optional)*: Primary currency identifier. - **profileDetails.primary\_currency.code** *(string, optional)*: Primary currency code. - **profileDetails.primary\_currency.sign** *(string, optional)*: Primary currency sign. - **profileDetails.primary\_currency.name** *(string, optional)*: Primary currency name. - **profileDetails.membership\_package.id** *(integer, optional)*: Membership package identifier. - **profileDetails.membership\_package.name** *(string, optional)*: Membership package name. - **profileDetails.jobs** *(array\[object], optional)*: Public job or skill entries from the extended profile. - **profileDetails.jobs\[].id** *(integer, optional)*: Job identifier. - **profileDetails.jobs\[].name** *(string, optional)*: Job or skill name. - **profileDetails.jobs\[].seo\_url** *(string, optional)*: Job or skill slug. - **profileDetails.qualifications** *(array\[object], optional)*: Public qualification entries when available. - **profileDetails.badges** *(array\[object], optional)*: Public badge entries when available. - **fingerprint** *(string, optional)*: Stable record fingerprint for change tracking. ### Data guarantees & handling - **Best-effort extraction:** fields may vary by region/session/availability/UI experiments. - **Optional fields:** null-check in downstream code. - **Deduplication:** recommend `type + ":" + id`. ### How to Run on Apify 1. Open the Actor in Apify Console. 2. Configure your search parameters, such as keywords, category, country, and optional rating or hourly-rate filters. 3. Set the maximum number of outputs to collect. 4. Click **Start** and wait for the run to finish. 5. Download results in JSON, CSV, Excel, or other supported formats. ### Scheduling & Automation #### Scheduling **Automated Data Collection** You can schedule runs to keep your freelancer dataset fresh without starting each run manually. This is useful for recurring sourcing, benchmarking, enrichment, and monitoring workflows. - Navigate to **Schedules** in Apify Console - Create a new schedule (daily, weekly, or custom cron) - Configure input parameters - Enable notifications for run completion - Optional: add webhooks for automated processing #### Integration Options - **Webhooks:** Trigger downstream actions when a run completes - **Zapier:** Connect to 5,000+ apps without coding - **Make (Integromat):** Build multi-step automation workflows - **Google Sheets:** Export results to a spreadsheet - **Slack/Discord:** Receive notifications and summaries - **Email:** Send automated reports via email ### Performance - **Small runs (< 1,000 outputs):** ~2-3 minutes - **Medium runs (1,000-5,000 outputs):** ~5-15 minutes - **Large runs (5,000+ outputs):** ~15-30 minutes Execution time varies based on filters, result volume, and how much information is returned per record. ### Compliance & Ethics #### Responsible Data Collection This actor collects publicly available freelancer profile information from https://www.freelancer.com for legitimate business purposes, including talent market research and market analysis, sourcing and vendor discovery, and competitive benchmarking. Users are responsible for ensuring that collection, storage, and downstream use comply with applicable laws, regulations, contractual obligations, and the target site's terms. This section is informational and not legal advice. #### Best Practices - Use collected data in accordance with applicable laws, regulations, and the target site's terms - Respect individual privacy and personal information - Use data responsibly and avoid disruptive or excessive collection - Do not use this actor for spamming, harassment, or other harmful purposes - Follow relevant data protection requirements where applicable (e.g., GDPR, CCPA) ### Support If you need help, open an issue on the actor page or use the support section on the Apify actor listing. Include the input you used in redacted form, the run ID, a short description of expected versus actual behavior, and an optional small output sample so the issue can be reproduced quickly. # Actor input Schema ## `enrich_data` (type: `boolean`): When enabled, results can include extra data such as lifetime earnings, portfolio details, location, image assets, profile stats, and more alongside the regular listing fields. ## `queries` (type: `array`): Add one or more search terms such as skills, job titles, niches, services, or freelancer names to find relevant profiles faster. ## `hourly_rate` (type: `string`): Use this to focus on freelancers within a target hourly budget and surface candidates that better fit your pricing expectations. ## `country` (type: `string`): Use this to find talent from a specific country and combine it with other filters for a more relevant shortlist. ## `min_rating` (type: `string`): Use this to surface freelancers who meet your preferred rating threshold based on their public Freelancer profile. ## `currently_online` (type: `boolean`): Enable this to prioritize profiles that appear online now, which can help with quicker outreach and response times. ## `category` (type: `string`): Use this to surface freelancers aligned with a specific work category, from development and design to writing, marketing, support, and more. ## `limit` (type: `integer`): Set a cap on saved results for each search or input when you want a more targeted, manageable lead list. ## `proxyConfiguration` (type: `object`): Optional Apify or custom proxy settings to help keep data collection more stable and consistent. ## Actor input object example ```json { "enrich_data": false, "currently_online": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("fatihtahta/freelancer-com-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 = {} # Run the Actor and wait for it to finish run = client.actor("fatihtahta/freelancer-com-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 '{}' | apify call fatihtahta/freelancer-com-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fatihtahta/freelancer-com-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Freelancer.com Freelancer Scraper | Enterprise Grade", "description": "Extract structured Freelancer.com freelancer profiles with hourly rates, earnings, skills, portfolios, reviews, reputation signals and more. Built for enterprise-grade talent sourcing, marketplace intelligence, lead enrichment, and automated recruiting or analytics pipelines.", "version": "0.0", "x-build-id": "LgxLeprsNpa3fOl4d" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~freelancer-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-freelancer-com-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/fatihtahta~freelancer-com-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-freelancer-com-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/fatihtahta~freelancer-com-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-freelancer-com-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": { "enrich_data": { "title": "Include richer profile insights", "type": "boolean", "description": "When enabled, results can include extra data such as lifetime earnings, portfolio details, location, image assets, profile stats, and more alongside the regular listing fields.", "default": false }, "queries": { "title": "Keywords or roles to discover", "type": "array", "description": "Add one or more search terms such as skills, job titles, niches, services, or freelancer names to find relevant profiles faster.", "items": { "type": "string" } }, "hourly_rate": { "title": "Preferred hourly rate range", "enum": [ "<$10/hour", "$10-$20/hour", "$20-$30/hour", "$30-$40/hour", ">$40/hour" ], "type": "string", "description": "Use this to focus on freelancers within a target hourly budget and surface candidates that better fit your pricing expectations." }, "country": { "title": "Preferred freelancer country", "enum": [ "Afghanistan", "Aland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bonaire, Saint Eustatius and Saba", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo", "Congo, The Democratic Republic of the", "Cook Islands", "Costa Rica", "Cote D'Ivoire", "Croatia", "Cuba", "Curacao", "Cyprus", "Czech Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Falkland Islands (Malvinas)", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Holy See (Vatican City State)", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran, Islamic Republic of", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Korea, Democratic People's Republic of", "Korea, Republic of", "Kosovo", "Kuwait", "Kyrgyzstan", "Lao People's Democratic Republic", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macau", "Macedonia", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia, Federated States of", "Moldova, Republic of", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "Northern Cyprus", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestinian Territory", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn Islands", "Poland", "Portugal", "Puerto Rico", "Qatar", "Reunion", "Romania", "Russian Federation", "Rwanda", "Saint Barthelemy", "Saint Helena", "Saint Kitts and Nevis", "Saint Lucia", "Saint Martin", "Saint Pierre and Miquelon", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten (Dutch part)", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "Spain", "Sri Lanka", "Sudan", "Suriname", "Svalbard and Jan Mayen", "Swaziland", "Sweden", "Switzerland", "Syrian Arab Republic", "Taiwan", "Tajikistan", "Tanzania, United Republic of", "Thailand", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "United States Minor Outlying Islands", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Vietnam", "Virgin Islands, British", "Virgin Islands, U.S.", "Wallis and Futuna", "Western Sahara", "Yemen", "Zambia", "Zimbabwe" ], "type": "string", "description": "Use this to find talent from a specific country and combine it with other filters for a more relevant shortlist." }, "min_rating": { "title": "Minimum client rating", "enum": [ "1 star and up", "2 star and up", "3 star and up", "4 star and up", "5 star" ], "type": "string", "description": "Use this to surface freelancers who meet your preferred rating threshold based on their public Freelancer profile." }, "currently_online": { "title": "Only show currently online freelancers", "type": "boolean", "description": "Enable this to prioritize profiles that appear online now, which can help with quicker outreach and response times.", "default": false }, "category": { "title": "Target service category", "enum": [ "build-a-website", "build-an-online-store", "get-traffic-to-my-website", "write-some-software", "convert-a-template-to-a-website", "create-a-wordpress-template", "create-a-joomla-template", "create-a-drupal-template", "develop-a-mac-application", "write-an-iphone-application", "write-an-ipad-application", "write-a-blackberry-application", "write-an-android-application", "create-a-mobile-website", "write-some-articles", "write-a-book", "write-a-report", "research-writing", "write-a-technical-report", "do-some-blog-posting", "translate-something", "edit-something", "proofread-something", "write-an-ebook", "rewrite-some-articles-for-me", "submit-articles-for-me", "write-my-product-descriptions", "write-a-tag-line-slogan", "content-writing", "design-a-website-mockup", "design-a-banner", "design-a-logo", "design-in-flash", "alter-some-images", "design-some-icons", "design-some-business-cards", "design-some-stationery", "develop-a-corporate-identity", "illustrate-something", "create-a-video", "design-an-advertisement", "design-a-t-shirt", "create-print-and-packaging-designs", "do-some-3d-modelling", "create-an-animation", "design-a-facebook-landing-page", "design-a-twitter-background", "i-need-some-graphic-design", "design-a-flyer", "design-a-brochure", "design-an-app-mockup", "design-a-wordpress-mockup", "design-some-fashion", "design-a-tattoo", "design-a-powerpoint-template", "architecture-design", "i-need-a-packaging-design", "submit-some-articles", "analyze-some-data", "fill-in-a-spreadsheet-with-data", "post-some-advertisements", "hire-a-virtual-assistant", "search-the-web-for-something", "find-information-from-websites", "do-some-excel-work", "help-with-customer-support", "design-me-a-product", "find-me-a-manufacturer", "find-me-a-buyer", "find-me-a-supplier", "manufacture-a-product-for-me", "assist-me-with-bulk-marketing", "telemarket-for-me", "help-me-with-internet-marketing", "find-me-some-leads", "sell-something-for-me", "help-me-with-marketing", "build-links-to-my-website", "seo-my-website", "create-manage-a-ppc-campaign", "build-me-a-twitter-following", "social-media-marketing", "manage-my-search-marketing", "write-a-business-plan", "find-an-accountant", "write-a-contract", "assist-with-project-management", "help-with-recruitment", "write-a-patent", "help-with-crm", "help-with-business-finance", "pickup-or-deliver-something", "clean-my-house-or-business", "help-me-move", "help-with-garden-maintenance", "assemble-some-furniture", "help-with-my-computer-laptop-device", "install-something-at-my-home", "take-some-photos", "get-help-from-a-handyman", "general-labour", "make-a-video" ], "type": "string", "description": "Use this to surface freelancers aligned with a specific work category, from development and design to writing, marketing, support, and more." }, "limit": { "title": "How many profiles to collect", "minimum": 1, "type": "integer", "description": "Set a cap on saved results for each search or input when you want a more targeted, manageable lead list." }, "proxyConfiguration": { "title": "Stability and proxy settings", "type": "object", "description": "Optional Apify or custom proxy settings to help keep data collection more stable and consistent.", "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 } } }, "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 } } } } } } } } } } ```