# Freelancer.com Scraper (`parsebird/freelancer-com-scraper`) Actor Scrape freelance projects from Freelancer.com by keyword, category, budget, and job type. Extract project title, description, skills, budget in USD, bid count, average bid, deadline, and direct URL. Export as JSON, CSV, or Excel. - **URL**: https://apify.com/parsebird/freelancer-com-scraper.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Categories:** - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.79 / 1,000 project scrapeds 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 Scraper Scrape freelance projects from **[Freelancer.com](https://www.freelancer.com)** into clean, structured JSON. The Freelancer.com Scraper pulls the project title, full description, required skills, budget in USD, bid count and average bid, deadline, and direct URL for any keyword or category search, with no login and no Freelancer.com API key.
Search Freelancer.com by keyword, category, job type, and budget, and get a structured record per project — skills with IDs, USD budget bounds, bid stats, time left, and the featured / urgent / NDA flags — straight from Freelancer's own project feed.
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ``` Actor: parsebird/freelancer-com-scraper (Apify). Scrapes projects from freelancer.com. Call with ApifyClient. Input JSON fields: keyword: string (default "seo") — free-text job keyword or skill category: string (default "seo") — Freelancer category / skill slug, e.g. "seo", "web-development", "graphic-design" jobType: "all" | "fixed" | "hourly" (default "all") minBudget / maxBudget: int USD — client-side budget filter sortBy: "relevance" | "newest" | "budget" (default "relevance") results_wanted: int (default 20, max 1000) — number of billed rows max_pages: int (default 20, max 100) — 100 projects per page startUrl: string — a public freelancer.com/jobs URL; its category and fixed/hourly/min filters are read proxyConfiguration: { "useApifyProxy": false } Output: one dataset item per project — project_id, project_name, project_desc, project_desc_text, skills[], skill_ids[], skills_info[{id,name,seo_url}], budget_range, budget_min, budget_max, budget_currency, budget_min_usd, budget_max_usd, bid_count, bid_avg, date_posted, date_ends, time_left, featured, urgent, sealed, nda, is_contest, project_status, language, country, vicinity, location_name, url, source, fetched_at. Example: { "keyword": "wordpress developer", "jobType": "fixed", "minBudget": 100, "maxBudget": 1000, "results_wanted": 50 } API: https://api.apify.com/v2/acts/parsebird~freelancer-com-scraper · Token: https://console.apify.com/account/integrations ``` ### What does Freelancer.com Scraper do? [Freelancer.com](https://www.freelancer.com) is one of the largest freelance marketplaces, with thousands of new projects posted every day across web development, design, writing, marketing, and more. This Freelancer.com scraper reads Freelancer's public project feed and returns: - 📋 **Project details** — title, full description (markdown and clean plain text), and status. - 🏷️ **Skills** — every skill tag, with its Freelancer skill ID and SEO slug. - 💰 **Budget** — the posted range in the project's currency and converted to USD. - 📊 **Bidding** — number of bids and the average bid amount. - ⏳ **Timing** — when the project was posted, when bidding closes, and time left. - ⭐ **Upgrades** — featured, urgent, sealed, and NDA flags. - 🔗 **URL** — the canonical project page. Common uses: freelancer lead generation, marketplace and rate research, tracking demand for a skill or stack, and feeding a project-alert product. ### Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | keyword | string | No | `seo` | Free-text job keyword or skill. | | category | string | No | `seo` | Freelancer category / skill slug. Combined with the keyword. | | jobType | string | No | `all` | `all`, `fixed`, or `hourly`. | | minBudget | integer | No | — | Minimum project budget in USD (client-side filter). | | maxBudget | integer | No | — | Maximum project budget in USD (client-side filter). | | sortBy | string | No | `relevance` | `relevance`, `newest`, or `budget`. | | results\_wanted | integer | No | 20 | Maximum unique projects to save (max 1000). Billed rows. | | max\_pages | integer | No | 20 | Maximum result pages (100 projects per page). | | startUrl | string | No | — | A public freelancer.com/jobs URL; its category and filters are read. | | proxyConfiguration | object | No | Off | Optional proxy. The public API works without one. | #### Example inputs Active SEO projects: ```json { "category": "seo", "results_wanted": 20 } ``` Fixed-price WordPress projects within a budget range, newest first: ```json { "keyword": "wordpress developer", "jobType": "fixed", "minBudget": 100, "maxBudget": 1000, "sortBy": "newest", "results_wanted": 50 } ``` Reuse a filtered Freelancer.com URL: ```json { "startUrl": "https://www.freelancer.com/jobs/seo?fixed=true&fixed_min=250", "results_wanted": 30, "max_pages": 5 } ``` ### What data can you extract from Freelancer.com? | Field | Description | |-------|-------------| | project\_id | Unique project ID | | project\_name | Project title | | project\_desc / project\_desc\_text | Full description (markdown) and clean text | | skills / skill\_ids / skills\_info | Skill names, IDs, and `{id, name, seo_url}` objects | | budget\_range | `Fixed` or `Hourly` | | budget\_min / budget\_max / budget\_currency | Posted budget in the project's currency | | budget\_min\_usd / budget\_max\_usd | Budget converted to USD | | bid\_count / bid\_avg | Number of bids and average bid (USD) | | date\_posted / date\_ends / time\_left | Posting time, bidding deadline, and time remaining | | featured / urgent / sealed / nda / is\_contest | Project upgrade flags | | project\_status / language | Frontend status and description language | | country / vicinity / location\_name | Published location (when the project is location-tagged) | | url / source / fetched\_at | Project URL, source label, collection timestamp | ### Output example ```json { "project_id": 40278015, "project_name": "E-commerce Site Development", "project_desc_text": "I need a website developer to create an e-commerce site for selling physical products.", "skills": ["eCommerce", "HTML", "PHP", "WooCommerce"], "skill_ids": ["3", "17", "56", "137"], "skills_info": [ { "id": 56, "name": "eCommerce", "seo_url": "ecommerce" }, { "id": 137, "name": "WooCommerce", "seo_url": "woocommerce" } ], "budget_range": "Fixed", "budget_min_usd": 30, "budget_max_usd": 250, "bid_count": 62, "bid_avg": "$74", "date_posted": "2026-08-10T08:30:00Z", "date_ends": "2026-08-16T08:30:00Z", "time_left": "6 days left", "featured": false, "urgent": false, "url": "https://www.freelancer.com/projects/web-development/commerce-site-development-40278015", "source": "freelancer.com", "fetched_at": "2026-08-10T08:31:12.000Z" } ``` Download the dataset as **JSON, CSV, Excel, HTML, or XML** from the Storage tab or the [Apify API](https://docs.apify.com/api/v2). ### Use cases - **Freelancer lead generation** — pull fresh projects in your niche and pitch fast. - **Rate and market research** — analyse budget ranges and bid counts by skill and category. - **Skill-demand tracking** — monitor how many projects mention a stack or tool over time. - **Project-alert product** — power a notification service for new matching projects. ### How it works 1. **Resolve** — a `category` slug is resolved to a Freelancer skill ID; keyword, job type, and sort are applied to the project feed. 2. **Fetch** — Freelancer's public active-projects API is read 100 projects per page. 3. **Shape** — each project is flattened, budgets are converted to USD from the project's currency, and dates and time-left are computed. 4. **Filter** — `minBudget` / `maxBudget` are applied to the USD budget. 5. Rows stream to the dataset and stop at `results_wanted`. ### How much does it cost to scrape Freelancer.com? This actor is **pay per result** — charged once per project saved. | Plan | Price per 1,000 projects | |------|--------------------------| | Free | **$0.99** | | Bronze | **$0.89** | | Silver | **$0.89** | | Gold | **$0.79** | A small platform **Actor start** fee also applies per run. `results_wanted` is the exact number of billed rows. Scraping 1,000 projects on the Free plan costs about **$0.99**. Apify's monthly free platform usage covers small runs. ### How to scrape Freelancer.com 1. Click **Try for free** and sign in to Apify. 2. Enter a **keyword** and/or **category slug**. 3. Optionally set **job type**, **budget**, or **sort**. 4. Set **results wanted** (start low, e.g. 20). 5. Click **Start**, then watch rows appear in the **Output** tab. 6. Export from **Storage**, or pull results via the API. #### Run it via API Python: ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("parsebird/freelancer-com-scraper").call(run_input={ "keyword": "wordpress developer", "jobType": "fixed", "minBudget": 100, "results_wanted": 50, }) for project in client.dataset(run["defaultDatasetId"]).iterate_items(): print(project["project_name"], "-", project.get("budget_range"), "-", project.get("bid_count"), "bids") ``` JavaScript: ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: '' }); const run = await client.actor('parsebird/freelancer-com-scraper').call({ category: 'graphic-design', sortBy: 'newest', results_wanted: 100, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` Schedule recurring runs, add webhooks, or push results to Google Sheets, Slack, Zapier, and Make with [Apify integrations](https://docs.apify.com/platform/integrations). ### FAQ **Do I need a Freelancer.com account or API key?** No. The scraper reads Freelancer's public project feed. No login is required. **How current is the data?** Live. Each run reads Freelancer.com at that moment. Use Apify's scheduler to keep a dataset fresh. **Which category slugs are valid?** Any Freelancer skill slug — the value in a `freelancer.com/jobs/` URL, e.g. `seo`, `web-development`, `graphic-design`, `content-writing`, `mobile-app-development`. **How does the budget filter work?** Budgets are converted to USD from each project's currency, then `minBudget` / `maxBudget` keep projects whose USD range overlaps yours. **Why are `country` and `payment_verified` sometimes empty?** Freelancer only exposes buyer location and payment-verification for location-tagged projects and to logged-in users; most public projects come back without them. **Something's not working.** Open an issue on the **Issues** tab with your input and the run link — we respond quickly. ### Is it legal to scrape Freelancer.com? Scraping publicly available data is legal in most jurisdictions, and this actor only reads Freelancer's public project feed — no login, no private data. You are responsible for how you use the data — respect Freelancer.com's Terms and Conditions and applicable law, and consult a lawyer if you are unsure. See Apify's guide on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). ### Related actors - [Fiverr Scraper](https://apify.com/parsebird/fiverr-scraper) — gigs, sellers, packages, and prices. - [Workana Jobs Scraper](https://apify.com/parsebird/workana-jobs-scraper) — Latin American freelance projects. - [Indeed Jobs Scraper](https://apify.com/parsebird/indeed-jobs-scraper) — job listings from Indeed worldwide. - [Hiring.cafe Scraper](https://apify.com/parsebird/hiring-cafe-scraper) — aggregated jobs with 20+ filters. Browse all [ParseBird actors](https://apify.com/parsebird) on Apify Store. # Actor input Schema ## `keyword` (type: `string`): Free-text job keyword or skill, e.g. "wordpress developer", "SEO", "logo design". ## `category` (type: `string`): Freelancer.com category / skill slug, e.g. "seo", "web-development", "graphic-design". Combined with the keyword when both are set. ## `jobType` (type: `string`): Filter by project type. ## `minBudget` (type: `integer`): Keep only projects whose USD budget maximum is at least this. ## `maxBudget` (type: `integer`): Keep only projects whose USD budget minimum is at most this. ## `sortBy` (type: `string`): Result ordering. ## `results_wanted` (type: `integer`): Maximum number of unique project records to save (max 1000). This is the number of billed rows. ## `max_pages` (type: `integer`): Maximum result pages to process (100 projects per page, max 100). ## `startUrl` (type: `string`): A public Freelancer.com jobs URL (e.g. https://www.freelancer.com/jobs/seo?fixed=true\&fixed\_min=250). Its category and filters are read and merged with the fields above. ## `proxyConfiguration` (type: `object`): Optional Apify proxy settings. Freelancer.com's public API works without a proxy. ## Actor input object example ```json { "keyword": "seo", "category": "seo", "jobType": "all", "sortBy": "relevance", "results_wanted": 20, "max_pages": 20, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `dataset` (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 = { "keyword": "seo", "category": "seo", "results_wanted": 20, "max_pages": 20, "startUrl": "" }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/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 = { "keyword": "seo", "category": "seo", "results_wanted": 20, "max_pages": 20, "startUrl": "", } # Run the Actor and wait for it to finish run = client.actor("parsebird/freelancer-com-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keyword": "seo", "category": "seo", "results_wanted": 20, "max_pages": 20, "startUrl": "" }' | apify call parsebird/freelancer-com-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/freelancer-com-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/St0j45mz6X3ptPSgJ/builds/l2KhYKSCXP7wsoUVl/openapi.json