# Freelancer Jobs Details Scraper (`soft_alexist/freelancer-jobs-details-scraper`) Actor Automate extraction of freelance project listings from Freelancer.com with precision. Scrape titles, budgets, client info, bids, skills required, timelines, and 24+ fields per project — perfect for market research, bid analysis, and skills trend tracking. - **URL**: https://apify.com/soft\_alexist/freelancer-jobs-details-scraper.md - **Developed by:** [Soft Alexist](https://apify.com/soft_alexist) (community) - **Categories:** Automation, Developer tools, Jobs - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Jobs Scraper: Capture Freelance Project Details Instantly --- ### What Is Freelancer.com? Freelancer.com is one of the world's largest freelance marketplaces, hosting hundreds of thousands of active projects ranging from writing and design to software development and business services. Projects span all budget ranges and skill levels, making it an invaluable source for understanding gig economy trends. Extracting project details manually is inefficient and error-prone — the **Freelancer.com Jobs Scraper** automates this process, delivering structured project data at scale. --- ### Overview The **Freelancer Jobs Scraper** extracts comprehensive project detail pages from Freelancer.com, converting unstructured listings into clean, machine-readable records. It is designed for: - **Freelancers** researching market rates, competition, and emerging skill demands - **Marketers** analyzing gig economy trends and competitor activity - **Researchers** studying freelance labor markets and project characteristics - **Aggregator platforms** building freelance job databases or comparison tools - **Business analysts** tracking project volume, budgets, and hiring patterns Key features include flexible URL input, graceful error handling via `ignore_url_failures`, and rich output spanning 24+ fields covering project scope, budget, timeline, and engagement metrics. --- ### Input Format The scraper accepts a minimal JSON configuration: ```json { "urls": [ "https://www.freelancer.com/projects/shopify-site/multi-platform-craft-store-setup" ], "ignore_url_failures": true } ```` #### Input Parameters Explained | Parameter | Type | Description | |---|---|---| | `urls` | Array (required) | List of direct Freelancer.com project detail page URLs. Paste the full project URL (e.g., `https://www.freelancer.com/projects/[category]/[project-slug]`). Supports bulk entry via UI. | | `ignore_url_failures` | Boolean (optional) | If `true`, the scraper continues running even if individual URLs fail to load or are deleted. If `false`, any failure halts the entire run. Recommended: `true` for batch operations. | > **Tip:** To find project URLs, browse Freelancer.com, open a project detail page, and copy the URL from your browser's address bar. *** ### Output Format **Sample output** ```json { "id": "shopify-site/multi-platform-craft-store-setup", "project_id": 40568188, "bids": [], "bid_stats": { "bid_count": 0, "bid_avg": 0 }, "breadcrumb": { "skill": "Shopify", "url": "shopify-site" }, "budget": { "min": 30, "max": 250 }, "client": { "registration_time": 1783498735000, "address": { "city": "Antioch", "country": "United States", "country_code": "us" }, "rating": { "average": 0, "review_count": 0 }, "verification": { "payment_verified": false, "email_verified": true, "profile_complete": false, "phone_verified": true, "deposit_made": false } }, "currency_details": { "id": 1, "code": "USD", "sign": "$", "name": "US Dollar", "exchange_rate": 1, "country": "US", "is_external": false }, "days_left": 6, "description": "I need help turning my small brand, [login to view URL], into a series of fully functional online stores. The focus is simple: showcase my art pieces on Etsy while selling clothing and other items on TikTok Shop, Amazon, eBay, Shopify’s free-trial tier, and any additional marketplaces that offer a no-cost entry level.\n\nHere’s what I’m after: \n\n• Open or verify seller accounts on each platform listed above. \n• Build an appealing storefront for every channel, carrying over the TeeTinyBoutique look where it makes sense, yet allowing Etsy to keep its own vibe. \n• Upload an initial batch of products with polished titles, descriptions, pricing, and photos (I’ll supply images; you optimise and post). \n• Configure basics that drive sales—shipping profiles, payment settings, shop policies, and to make sales\n\nIf you have experience launching handmade on etsy and or boutique brands across other multiple marketplaces and can move quickly while keeping the details tidy, I’d love to work together.", "end_time": 1784103602000, "formatted_budget": "$30-250 USD", "hours_left": 23, "type": "fixed", "is_local": false, "latest_activity_time": 0, "next_project": { "title": "Convert WordPress website to HTML Conversion", "seo_url": "javascript/convert-wordpress-website-html" }, "previous_project": { "title": "Maintain & Optimize PHP Content Sites", "seo_url": "web-development/maintain-optimize-php-content-sites" }, "selected_bids": [], "similar_jobs": [ { "title": "# Experto en tiendas Amazon y TikTok requerido", "seo_url": "/projects/amazon/experto-tiendas-amazon-tiktok-requerido", "formatted_budget": "$30-250 USD" }, { "title": "Full E-Commerce Website Development", "seo_url": "/projects/web-development/full-commerce-website-development-40564925", "formatted_budget": "$250-750 USD" }, { "title": "Shopify Ecommerce Revamp for Trellis Bliss", "seo_url": "/projects/shopify-site/shopify-ecommerce-revamp-for-trellis", "formatted_budget": "₹12500-37500 INR" }, { "title": "Shopify CRO for Higher Conversions", "seo_url": "/projects/ab-testing/shopify-cro-for-higher-conversions", "formatted_budget": "$250-750 USD" }, { "title": "Amazon eBay Etsy Store Manager", "seo_url": "/projects/ecommerce/amazon-ebay-etsy-store-manager", "formatted_budget": "$250-750 USD" }, { "title": "Social Media Content Creator (Instagram & TikTok)", "seo_url": "/projects/canva/social-media-content-creator-instagram", "formatted_budget": "$25-50 AUD / hour" }, { "title": "AI Course E-Commerce Website", "seo_url": "/projects/web-development/course-commerce-website", "formatted_budget": "₹1500-12500 INR" }, { "title": "Full Time Australian E-commerce Manager must speak write fluent Mandarin and English. Local Chinese . Malaysia/ Taiwan/ China/ Hong Kong applicants ", "seo_url": "/projects/shopify-site/full-time-australian-commerce-manager", "formatted_budget": "$2-8 AUD / hour" }, { "title": "Shopify Store Setup & Design", "seo_url": "/projects/digital-marketing/shopify-store-setup-design", "formatted_budget": "$15-25 CAD / hour" }, { "title": "Build Modern Portfolio Site on Shopify -- 2", "seo_url": "/projects/shopify-site/build-modern-portfolio-site-shopify", "formatted_budget": "$250-750 USD" }, { "title": "E-commerce Website Design Internship", "seo_url": "/projects/web-design/commerce-website-design-internship", "formatted_budget": "$8-15 AUD / hour" }, { "title": "Dynamic TikTok Video Editor Needed", "seo_url": "/projects/tiktok/dynamic-tiktok-video-editor-needed", "formatted_budget": "€8-30 EUR" }, { "title": "Elegant Shopify Store for Neck Ties", "seo_url": "/projects/shopify-development/elegant-shopify-store-for-neck", "formatted_budget": "₹1500-12500 INR" }, { "title": "Expert CapCut Editor for Social Media Videos", "seo_url": "/projects/capcut/expert-capcut-editor-for-social", "formatted_budget": "$2-8 AUD / hour" }, { "title": "looking for etsy VA to work on percentage basis", "seo_url": "/projects/etsy/looking-for-etsy-work-percentage", "formatted_budget": "$10-30 USD" }, { "title": "Bridal Party Gift Mockups", "seo_url": "/projects/photo-editing/bridal-party-gift-mockups", "formatted_budget": "$25-50 AUD / hour" }, { "title": "Etsy Shop Enhancement", "seo_url": "/projects/etsy/etsy-shop-enhancement", "formatted_budget": "$10-30 USD" }, { "title": "Pay for 100 Real USA kindslot.com players", "seo_url": "/projects/internet-marketing/pay-for-real-usa-kindslot", "formatted_budget": "$30-250 USD" }, { "title": "Padel Reels Video Editor", "seo_url": "/projects/adobe-premiere-pro/padel-reels-video-editor", "formatted_budget": "£10-20 GBP" }, { "title": "Need a CapCut Editor for Social Media Videos", "seo_url": "/projects/capcut/need-capcut-editor-for-social", "formatted_budget": "$2-8 AUD / hour" } ], "skills": [ { "id": 502, "name": "Shopify", "category": { "id": 1 }, "local": false, "seo_url": "shopify-site", "active_project_count": 107 }, { "id": 1712, "name": "Amazon", "category": { "id": 8 }, "local": false, "seo_url": "amazon", "active_project_count": 28 }, { "id": 754, "name": "Etsy", "category": { "id": 6 }, "local": false, "seo_url": "etsy", "active_project_count": 6 }, { "id": 38, "name": "SEO", "category": { "id": 1 }, "local": false, "seo_url": "seo", "active_project_count": 479 }, { "id": 137, "name": "eCommerce", "category": { "id": 1 }, "local": false, "seo_url": "ecommerce", "active_project_count": 118 }, { "id": 17, "name": "Website Design", "category": { "id": 3 }, "local": false, "seo_url": "website-design", "active_project_count": 671 }, { "id": 335, "name": "HTML", "category": { "id": 1 }, "local": false, "seo_url": "html", "active_project_count": 676 }, { "id": 251, "name": "eBay", "category": { "id": 6 }, "local": false, "seo_url": "ebay", "active_project_count": 18 }, { "id": 1927, "name": "TikTok", "category": { "id": 6 }, "local": false, "seo_url": "tiktok", "active_project_count": 36 }, { "id": 1175, "name": "Account Management", "category": { "id": 7 }, "local": false, "seo_url": "account-management", "active_project_count": 98 } ], "start_time": 1783498802000, "status": "active", "title": "Multi-Platform Craft Store Setup", "seo_url": "shopify-site/multi-platform-craft-store-setup" } ``` Each scraped project returns a comprehensive record with 24+ fields: #### Project Identification | Field | Meaning | |---|---| | `ID` | Unique internal Freelancer identifier for the project | | `Project ID` | Alternative project ID reference | | `Title` | Project title as displayed on the listing | | `SEO URL` | URL-friendly slug version of the project title | | `Description` | Full project description, including scope and requirements | #### Budget & Financial Details | Field | Meaning | |---|---| | `Budget` | Raw budget amount (numeric value) | | `Formatted Budget` | Budget displayed with currency symbol and formatting (e.g., "$500–$1000") | | `Currency Details` | Metadata about the currency (code, symbol, exchange info) | | `Type` | Project pricing model (e.g., fixed-price, hourly, contest) | #### Timeline & Status | Field | Meaning | |---|---| | `Start Time` | Project publication/creation timestamp | | `End Time` | Project deadline or completion date | | `Days Left` | Days remaining until project closes (calculated field) | | `Hours Left` | Hours remaining until project closes (calculated field) | | `Latest Activity Time` | Timestamp of the most recent activity (bid, comment, update) | | `Status` | Current project status (e.g., open, pending, awarded, completed) | #### Bidding & Engagement | Field | Meaning | |---|---| | `Bids` | Total number of bids received on the project | | `Bid Stats` | Detailed bidding statistics (bid range, average bid, bidder counts) | | `Selected Bids` | Number of bids shortlisted or selected by the client | #### Project Details | Field | Meaning | |---|---| | `Skills` | Array of required skills/technologies (e.g., `["React", "Node.js", "MongoDB"]`) | | `Is Local` | Boolean flag indicating if the project requires local/in-person work | | `Breadcrumb` | Navigation path showing project category hierarchy | #### Navigation & Relationships | Field | Meaning | |---|---| | `Client` | Freelancer client profile info (name, rating, verification status) | | `Next Project` | Link/reference to the next project in the category | | `Previous Project` | Link/reference to the previous project in the category | | `Similar Jobs` | List of related projects or recommended opportunities | *** ### How to Use 1. **Identify project URLs** — Visit Freelancer.com, browse projects, and open project detail pages. Copy the full URL. 2. **Paste URLs** — Add URLs to the `urls` input field, one per line or using bulk edit. You can scrape a single URL or hundreds simultaneously. 3. **Configure error handling** — Set `ignore_url_failures: true` to skip deleted or unavailable projects without interrupting the run. 4. **Execute the scraper** — Start the run and monitor progress via the logs. 5. **Export results** — Download the scraped data as JSON, CSV, or Excel for analysis or integration. **Best practices:** - Verify URLs are project *detail* pages (not search results or portfolio pages). - For large batches, always enable `ignore_url_failures` — projects may be deleted or archived during your run. - Extract data during off-peak hours to minimize server load. *** ### Use Cases & Business Value - **Rate benchmarking:** Analyze budget ranges and hourly rates across skills and categories - **Skill demand analysis:** Identify trending technologies and most-requested competencies - **Market intelligence:** Track competitor activity, project volume, and client acquisition strategies - **Freelancer research:** Study bidding patterns, client ratings, and project complexity - **Job board aggregation:** Feed Freelancer data into your own job marketplace or aggregator platform - **Academic studies:** Research gig economy dynamics, labor supply, and project characteristics By automating data extraction, you eliminate manual work and unlock actionable insights that inform hiring, pricing, and business strategy. *** ### Conclusion The **Freelancer.com Jobs Scraper** is a powerful tool for anyone seeking structured project data from the world's largest freelance marketplace. With 24+ fields covering budgets, timelines, skills, and engagement metrics, it enables rapid market analysis and data-driven decision-making. Start scraping today and transform Freelancer listings into competitive intelligence. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the Specific jobs urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## Actor input object example ```json { "urls": [ "https://www.freelancer.com/projects/shopify-site/multi-platform-craft-store-setup" ], "ignore_url_failures": true } ``` # 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 = { "urls": [ "https://www.freelancer.com/projects/shopify-site/multi-platform-craft-store-setup" ], "ignore_url_failures": true }; // Run the Actor and wait for it to finish const run = await client.actor("soft_alexist/freelancer-jobs-details-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 = { "urls": ["https://www.freelancer.com/projects/shopify-site/multi-platform-craft-store-setup"], "ignore_url_failures": True, } # Run the Actor and wait for it to finish run = client.actor("soft_alexist/freelancer-jobs-details-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 '{ "urls": [ "https://www.freelancer.com/projects/shopify-site/multi-platform-craft-store-setup" ], "ignore_url_failures": true }' | apify call soft_alexist/freelancer-jobs-details-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=soft_alexist/freelancer-jobs-details-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Freelancer Jobs Details Scraper", "description": "Automate extraction of freelance project listings from Freelancer.com with precision. Scrape titles, budgets, client info, bids, skills required, timelines, and 24+ fields per project — perfect for market research, bid analysis, and skills trend tracking.", "version": "0.0", "x-build-id": "jcvs57aknB4dErAnY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/soft_alexist~freelancer-jobs-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-soft_alexist-freelancer-jobs-details-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/soft_alexist~freelancer-jobs-details-scraper/runs": { "post": { "operationId": "runs-sync-soft_alexist-freelancer-jobs-details-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/soft_alexist~freelancer-jobs-details-scraper/run-sync": { "post": { "operationId": "run-sync-soft_alexist-freelancer-jobs-details-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": { "urls": { "title": "URLs of the Specific jobs urls to scrape", "type": "array", "description": "Add the URLs of the Specific jobs urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." } } }, "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 } } } } } } } } } } ```