# Freelancermap Projects Scraper (`automation-lab/freelancermap-projects-scraper`) Actor Extract public freelance project listings from Freelancermap by keyword or URL for recruiting, staffing, and market research workflows. - **URL**: https://apify.com/automation-lab/freelancermap-projects-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 ## Freelancermap Projects Scraper Extract public freelance and contract project listings from Freelancermap search pages. Freelancermap is a popular marketplace for DACH and European freelance project demand. This actor turns public project search pages into structured datasets you can filter, export, enrich, and monitor. ### What does Freelancermap Projects Scraper do? Freelancermap Projects Scraper collects public project listing data from `freelancermap.com/projects`. It can scrape by keyword or from existing Freelancermap project search URLs. Typical output includes project title, company, country, city, contract type, start text, duration, budget, skills, project URL, posted date, and description text. ### Who is it for? **Recruiting teams and staffing agencies** Recruiters use it to watch new freelance contract demand by skill, client, country, or remote market. Staffing agencies use it to track target markets such as SAP, React, Python, DevOps, or data engineering and prioritize sectors with active project postings. **Freelancers and consultants** Freelancers use it to monitor project volume, compare demand across technologies, and spot fresh opportunities without manually refreshing the marketplace. **Market analysts and operations teams** Market analysts use it to build DACH and EU freelance-market dashboards. Sales and operations teams use it to identify companies posting contract needs and trigger alerts for high-fit opportunities. ### Why use this actor? ✅ Export listings without manually copying search results. ✅ Run recurring monitors for fresh projects. ✅ Combine keyword and filtered URL searches in one run. ✅ Get clean JSON, CSV, Excel, XML, or RSS from Apify datasets. ✅ Use the Apify API, webhooks, integrations, and MCP tools. ### What data can it extract? | Field | Description | | --- | --- | | `id` | Freelancermap project ID | | `title` | Project listing title | | `url` | Public project URL | | `company` | Listed company or client name | | `posterName` | Poster contact name when public | | `posterCompany` | Poster company when public | | `country` | Project country | | `city` | Project city when provided | | `locations` | Location objects from the search payload | | `contractType` | Contract type from Freelancermap | | `beginningText` | Public start date text | | `durationText` | Public duration text | | `budget` | Budget or rate text when public | | `skills` | Skill tags attached to the project | | `description` | Plain-text project description | | `createdAt` | Listing creation timestamp | | `sourceUrl` | Search result page where the listing was found | | `searchQuery` | Keyword used for generated searches | ### How much does it cost to scrape Freelancermap projects? This actor uses pay-per-event pricing. You pay a small start fee per run and a per-project fee for each saved listing. The current start fee is **$0.005 per run**. Per-project pricing uses tier discounts, so high-volume users pay less per saved listing. | Plan tier | Price per saved project | Estimated 25-project run | Estimated 100-project run | | --- | ---: | ---: | ---: | | Free | $0.00014524 | about $0.0086 | about $0.0195 | | Bronze | $0.00012630 | about $0.0082 | about $0.0176 | | Silver | $0.00009851 | about $0.0075 | about $0.0149 | | Gold | $0.000075777 | about $0.0069 | about $0.0126 | | Platinum | $0.000050518 | about $0.0063 | about $0.0101 | | Diamond | $0.000035363 | about $0.0059 | about $0.0085 | A free-plan user can run a quick 20-project sample for roughly **$0.008** before Apify platform credits or other account-level charges. The exact price shown on Apify is authoritative and may include current platform tier discounts. ### Input options #### Search queries Use `searchQueries` for skill or market terms. Examples: ```json ["react", "sap", "python"] ```` #### Start URLs Use `startUrls` when you already built a filtered search URL in Freelancermap. Example: ```json [{ "url": "https://www.freelancermap.com/projects?query=react" }] ``` #### Maximum project listings Use `maxItems` to cap total saved results across all queries and URLs. The default is intentionally low for a cheap first run. #### Include HTML description Enable `includeHtmlDescription` only if you need the raw formatted listing text. The default output includes a clean plain-text description. ### Example input ```json { "searchQueries": ["react"], "maxItems": 25, "sort": "1", "includeHtmlDescription": false } ``` ### Example output ```json { "id": 3012167, "title": "API Developer - Golang/Python", "url": "https://www.freelancermap.com/project/api-developer-golang-python-3012167", "company": "Talent Smart Limited", "country": "United Kingdom", "city": null, "contractType": "contracting", "beginningText": "asap", "durationText": "6 months", "budget": null, "skills": ["API", "Python"], "searchQuery": "react" } ``` ### How to run it 1. Open the actor on Apify. 2. Add one or more Freelancermap search queries. 3. Set the maximum number of project listings. 4. Click **Start**. 5. Download the dataset or connect it to your workflow. ### Tips for better results Use specific skills such as `SAP FICO`, `React Native`, or `Azure DevOps`. Run multiple related terms in one job to compare market demand. Use filtered start URLs when you need country, remote, category, or other filters from the website. Schedule the actor daily or hourly for freshness monitoring. ### Integrations Send new Freelancermap projects to Google Sheets. Trigger Slack alerts for matching project titles. Store project data in BigQuery, Snowflake, or S3. Enrich company names with your CRM or lead database. Use Apify webhooks to notify recruiters when new matching listings appear. ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/freelancermap-projects-scraper').call({ searchQueries: ['react'], maxItems: 25, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('automation-lab/freelancermap-projects-scraper').call({ 'searchQueries': ['react'], 'maxItems': 25, }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items) ``` ### API usage with cURL ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~freelancermap-projects-scraper/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"searchQueries":["react"],"maxItems":20}' ``` ### MCP usage Use this actor from Claude Desktop, Claude Code, or other MCP clients through Apify MCP. MCP server URL: ```text https://mcp.apify.com/?tools=automation-lab/freelancermap-projects-scraper ``` Claude Code setup: ```bash claude mcp add apify-freelancermap-projects --transport http https://mcp.apify.com/?tools=automation-lab/freelancermap-projects-scraper ``` Claude Desktop JSON configuration: ```json { "mcpServers": { "apify-freelancermap-projects": { "url": "https://mcp.apify.com/?tools=automation-lab/freelancermap-projects-scraper" } } } ``` Example prompts: - "Run Freelancermap Projects Scraper for SAP and summarize the countries." - "Find new React contract projects and export the dataset link." - "Compare Python and DevOps Freelancermap project counts this week." ### Scheduling workflows Create a daily schedule for recurring market monitoring. Use a webhook to send only completed run data to downstream systems. Keep `maxItems` aligned with your alerting volume. ### Data quality notes The actor extracts data visible in public Freelancermap search HTML. Some listings do not publish budgets, exact cities, or company details. Fields that are not visible publicly are returned as `null` or empty arrays. ### Troubleshooting #### Why did I get fewer results than maxItems? The search term or filtered URL may have fewer public results available. Try a broader skill keyword or remove restrictive filters. #### Why is the budget empty? Freelancermap listings often omit public rates or budgets. The actor only returns budget text when it is present in the public listing payload. ### FAQ #### Can I scrape filtered Freelancermap project URLs? Yes. Paste public `/projects` URLs into `startUrls` after setting filters on Freelancermap. #### Does this actor scrape freelancer profiles? No. This actor focuses on project demand. Use a profile-focused scraper for expert or consultant pages. ### Legality This actor extracts publicly available project listing metadata. You are responsible for using the data in compliance with applicable laws, website terms, and privacy obligations. Do not use scraped data for spam, unlawful profiling, or prohibited outreach. ### Related scrapers - [Freelancer Jobs Scraper](https://apify.com/automation-lab/freelancer-jobs-scraper) - [Freelancer Profiles Scraper](https://apify.com/automation-lab/freelancer-profiles-scraper) - [Xing Jobs Scraper](https://apify.com/automation-lab/xing-jobs-scraper) - [Karriere.at Job Listings Scraper](https://apify.com/automation-lab/karriere-at-job-listings-scraper) ### Support If a run fails, share the run URL and input with support. For best debugging, include one query or start URL that reproduces the issue. ### Changelog Initial version extracts public Freelancermap project search listings from embedded `ProjectSearch` JSON. # Actor input Schema ## `searchQueries` (type: `array`): Freelancermap project keywords or skills to search, for example React, SAP, Python, or DevOps. ## `startUrls` (type: `array`): Optional public Freelancermap /projects search URLs. Use this when you already configured filters on the website. ## `maxItems` (type: `integer`): Maximum number of project listings to save across all queries and start URLs. ## `sort` (type: `string`): Freelancermap sort query parameter used for generated search URLs. Keep the default unless you need to mirror another search URL. ## `includeHtmlDescription` (type: `boolean`): Also save the raw HTML project description in descriptionHtml. Disabled by default to keep exports compact. ## `useApifyProxy` (type: `boolean`): Route requests through Apify Proxy datacenter IPs. Recommended for cloud runs because Freelancermap may block direct cloud data-center traffic. ## Actor input object example ```json { "searchQueries": [ "react" ], "startUrls": [ { "url": "https://www.freelancermap.com/projects?query=react" } ], "maxItems": 20, "sort": "1", "includeHtmlDescription": false, "useApifyProxy": true } ``` # Actor output Schema ## `overview` (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 = { "searchQueries": [ "react" ], "startUrls": [ { "url": "https://www.freelancermap.com/projects?query=react" } ], "maxItems": 20, "sort": "1" }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/freelancermap-projects-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": ["react"], "startUrls": [{ "url": "https://www.freelancermap.com/projects?query=react" }], "maxItems": 20, "sort": "1", } # Run the Actor and wait for it to finish run = client.actor("automation-lab/freelancermap-projects-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": [ "react" ], "startUrls": [ { "url": "https://www.freelancermap.com/projects?query=react" } ], "maxItems": 20, "sort": "1" }' | apify call automation-lab/freelancermap-projects-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/freelancermap-projects-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Freelancermap Projects Scraper", "description": "Extract public freelance project listings from Freelancermap by keyword or URL for recruiting, staffing, and market research workflows.", "version": "0.1", "x-build-id": "FPk0ZvcB0GFbyyP8y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~freelancermap-projects-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-freelancermap-projects-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/automation-lab~freelancermap-projects-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-freelancermap-projects-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/automation-lab~freelancermap-projects-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-freelancermap-projects-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 queries", "type": "array", "description": "Freelancermap project keywords or skills to search, for example React, SAP, Python, or DevOps.", "items": { "type": "string" } }, "startUrls": { "title": "Freelancermap project search URLs", "type": "array", "description": "Optional public Freelancermap /projects search URLs. Use this when you already configured filters on the website.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum project listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of project listings to save across all queries and start URLs.", "default": 20 }, "sort": { "title": "Sort parameter", "type": "string", "description": "Freelancermap sort query parameter used for generated search URLs. Keep the default unless you need to mirror another search URL.", "default": "1" }, "includeHtmlDescription": { "title": "Include HTML description", "type": "boolean", "description": "Also save the raw HTML project description in descriptionHtml. Disabled by default to keep exports compact.", "default": false }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Route requests through Apify Proxy datacenter IPs. Recommended for cloud runs because Freelancermap may block direct cloud data-center traffic.", "default": true } } }, "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 } } } } } } } } } } ```