# Freelancermap Project Scraper (`alkausari_mujahid/freelancermap-project-scraper`) Actor
Turn freelancermap.de project searches into ready-to-use lead lists. Paste a search link and get every posting: title, company, contact person, location, remote share, start date, duration, skills, and full description. Ideal for freelancers finding gigs and agencies tracking demand.
- **URL**: https://apify.com/alkausari\_mujahid/freelancermap-project-scraper.md
- **Developed by:** [Alkausari M](https://apify.com/alkausari_mujahid) (community)
- **Categories:** Lead generation, Jobs, Integrations
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $10.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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
**Scrape project postings from [freelancermap.de](https://www.freelancermap.de/projekte) — Germany's largest IT freelancer marketplace — without writing a line of code.** Run any project search on the site, paste the link here, and this freelancermap project scraper extracts every posting: title, company, contact person, location, remote share, start date, duration, skills, and the full description. Results land in a structured dataset ready for Excel, your CRM, or the Apify API.
> Built and maintained by **Alkausari M**. Looking for freelancer profiles instead? See the **Freelancermap Profile Scraper**.
---
### What does Freelancermap Project Scraper do?
- 🔎 **Search-URL driven** — paste any freelancermap project search URL
- 📇 **Complete posting data** — company, contact person, remote share, dates, skills, full description
- 🔓 **Newest projects without login** — the first results page needs no account; deeper pages use your free freelancermap login
- 🛡 **Anti-blocking ready** — real browser, fingerprints, proxy support, smart retries
- 📊 **Any format** — JSON, CSV, Excel, XML, or live via the Apify API
- 🖱 **Zero code** — no setup, no scripts, just click Start
---
### How do I scrape freelancermap projects?
1. **Paste search URLs** — any freelancermap.de project search page (URLs whose path starts with `/projekte`, e.g. `/projekte?query=...`, `/projekte/remote`, or category pages). You can also paste **direct project URLs** (`/projekt/...`) to scrape specific postings. Other page types are not supported.
2. **Set the page range** — `startPage` → `endPage` (28 projects per page; applies to search URLs only). Pages beyond 1 require your freelancermap account (see below).
3. **Click Start** — parsing and retries handled for you.
```jsonc
// Example input — newest projects, no login
{
"startUrls": [
"https://www.freelancermap.de/projekte?query=Python",
"https://www.freelancermap.de/projekte/remote"
],
"maxItems": 50
}
````
#### Scraping beyond the first page (login required)
freelancermap only shows search result pages beyond page 1 to logged-in users. To paginate deeper, provide your (free) freelancermap account:
```jsonc
{
"startUrls": ["https://www.freelancermap.de/projekte?query=SAP"],
"startPage": 1,
"endPage": 10,
"maxItems": 250,
"email": "your@email.com",
"password": "yourpassword"
}
```
> \[!NOTE]
> If login fails (e.g. wrong credentials), the Actor retries up to 3 times and then stops the run.
Both plain strings and `{ "url": "..." }` objects are accepted in `startUrls`.
***
### What data can you extract from freelancermap projects?
Each item is one project posting, extracted from the rendered project page. Fields the poster left blank come back as empty strings or arrays, so your columns stay consistent.
```json
{
"url": "https://www.freelancermap.de/projekt/senior-cloud-engineer-m-w-d-1234567",
"title": "Senior Cloud Engineer (m/w/d)",
"company": "Beispiel GmbH",
"companyRegisteredSince": "Registriert seit 20.04.2026",
"contactPerson": "Max Mustermann",
"city": "Berlin, Dresden",
"country": "Deutschland",
"locations": ["Berlin", "Dresden"],
"remote": "60% Remote",
"contractType": "Freiberuflich",
"start": "ab sofort",
"duration": "5 Monate+",
"workload": "100% Auslastung",
"industry": "IT",
"isTopProject": true,
"isEndcustomerProject": false,
"skills": ["Kubernetes", "Terraform", "AWS", "CI/CD"],
"created": "13.07.2026",
"description": "Aufgaben:\nAufbau und Betrieb der Cloud-Infrastruktur...",
"descriptionHtml": "...
"
}
```
***
### Input settings
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `startUrls` | Array | Yes | — | freelancermap project search URLs (`/projekte...`) and/or direct project URLs (`/projekt/...`). Plain strings or `{url}` objects. |
| `startPage` | Integer | No | `1` | First listing page to scrape |
| `endPage` | Integer | No | `1` | Last listing page to scrape (28 projects per page). Values above 1 require `email` + `password`. |
| `maxItems` | Integer | No | `10` | Cap on total projects scraped — raise it for bigger runs |
| `email` | String | If `endPage` > 1 | — | freelancermap account email |
| `password` | String | If `endPage` > 1 | — | freelancermap password (stored securely, never logged) |
| `pageDelay` | Integer | No | `2` | Seconds to pause on each project page (1–5) |
| `proxyConfiguration` | Object | No | none | Proxy settings; the Actor works without a proxy by default |
***
### How much does it cost to scrape freelancermap projects?
The Actor runs on the [Apify platform](https://apify.com) — see the **Pricing** tab on this page for the current rate, and check Apify's free tier to try it at no cost. Costs scale with the number of projects scraped, so use `maxItems` and the page range to control run size. A test run with the default `maxItems: 10` tells you the per-project cost before a big scrape.
***
### Who is Freelancermap Project Scraper for?
- **Freelancers** — monitor new projects matching your skills across searches, on a schedule, without refreshing the site.
- **Agencies & staffing providers** — capture project leads with the posting company and contact person for follow-up.
- **Market research** — track demand by skill, region, remote share, and industry over time.
- **Job boards & aggregators** — feed fresh German-market IT projects into your own platform via the Apify API.
***
### Tips for best results
- **Filter on the site first** — set up your search (keywords, remote %, category) on freelancermap.de, then paste the result URL. The Actor scrapes exactly what you filtered.
- **Schedule it** — the newest postings are on page 1, which needs no login. A daily scheduled run with `endPage: 1` catches new projects as they appear and can push them to Slack, email, or Google Sheets via integrations.
- **Raise `maxItems`** — the default caps a run at 10 projects for quick tests; increase it (e.g. to 500) for real runs.
***
### Is there a freelancermap API?
freelancermap.de doesn't offer a public API — this Actor works as an **unofficial freelancermap projects API**. Every run produces a structured dataset you can pull as JSON, CSV, Excel, or XML via the [Apify API](https://docs.apify.com/api/v2), on a schedule or on demand.
#### Integrations
Connect the results to **Google Sheets, Make, Zapier, Slack, Airbyte**, or any webhook using [Apify integrations](https://apify.com/integrations) — no code required.
***
### FAQ
#### Do I need a freelancermap account?
Only for pagination. The newest results (page 1 of each search, up to 28 projects) are scraped without any login. To go deeper than page 1, provide your freelancermap account credentials — a free account is enough.
#### Can I get the poster's email address or phone number?
No — freelancermap doesn't publish them on project pages; applications go through the platform's own contact flow. What you do get for outreach is the contact person's name, the company name, and how long the company has been registered on the platform.
#### Can I scrape a specific project?
Yes — paste the project's URL (e.g. `https://www.freelancermap.de/projekt/senior-cloud-engineer-m-w-d-1234567`) into `startUrls`, alone or mixed with search URLs. The `startPage`/`endPage` range only applies to search URLs.
#### How many projects can I scrape per run?
Each search results page holds up to 28 projects (including "Top" placements, which are deduplicated automatically). Choose the page range with `startPage`/`endPage` — with account credentials for pages beyond 1 — and cap the total with `maxItems`.
#### Is it legal to scrape freelancermap.de?
The Actor collects data that companies have published publicly to attract freelancers. You are responsible for using it in line with freelancermap's [Terms of Service](https://www.freelancermap.de/nutzungsbedingungen.html), GDPR, and applicable law.
***
### Support
Bugs, feature requests, or custom scraping work — open an issue on Apify or email ****.
***
Built by **Alkausari M**. This Actor is independent and not affiliated with, endorsed by, or sponsored by freelancermap GmbH. Use scraped data responsibly and in accordance with freelancermap's [Terms of Service](https://www.freelancermap.de/nutzungsbedingungen.html), GDPR, and applicable law.
# Actor input Schema
## `startUrls` (type: `array`):
One or more freelancermap.de project search URLs (each paginated from Start Page to End Page) and/or direct project URLs (https://www.freelancermap.de/projekt/...) to scrape specific postings. Example: https://www.freelancermap.de/projekte
## `startPage` (type: `integer`):
First page of search results to scrape (1-based). Pages beyond 1 require account credentials (see below).
## `endPage` (type: `integer`):
Last page of search results to scrape. Each results page contains up to 28 projects. Pages beyond 1 require account credentials (see below).
## `maxItems` (type: `integer`):
Maximum total number of projects to scrape. Useful for quick tests and cost control.
## `email` (type: `string`):
Your freelancermap.de login email. Only required when End Page is greater than 1.
## `password` (type: `string`):
Your freelancermap.de login password. Only required when End Page is greater than 1. Stored securely and never logged.
## `pageDelay` (type: `integer`):
Delay in seconds to wait on each project page. Increase this if the scraper is being blocked or pages are not fully loading.
## `proxyConfiguration` (type: `object`):
Proxy settings for the crawler. The Actor works without a proxy by default; enable Apify proxies if you see blocked requests on large runs.
## Actor input object example
```json
{
"startUrls": [
"https://www.freelancermap.de/projekte"
],
"startPage": 1,
"endPage": 1,
"maxItems": 10,
"pageDelay": 2,
"proxyConfiguration": {
"useApifyProxy": false,
"apifyProxyGroups": []
}
}
```
# 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 = {
"startUrls": [
"https://www.freelancermap.de/projekte"
],
"maxItems": 10,
"proxyConfiguration": {
"useApifyProxy": false,
"apifyProxyGroups": []
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("alkausari_mujahid/freelancermap-project-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 = {
"startUrls": ["https://www.freelancermap.de/projekte"],
"maxItems": 10,
"proxyConfiguration": {
"useApifyProxy": False,
"apifyProxyGroups": [],
},
}
# Run the Actor and wait for it to finish
run = client.actor("alkausari_mujahid/freelancermap-project-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 '{
"startUrls": [
"https://www.freelancermap.de/projekte"
],
"maxItems": 10,
"proxyConfiguration": {
"useApifyProxy": false,
"apifyProxyGroups": []
}
}' |
apify call alkausari_mujahid/freelancermap-project-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=alkausari_mujahid/freelancermap-project-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Freelancermap Project Scraper",
"description": "Turn freelancermap.de project searches into ready-to-use lead lists. Paste a search link and get every posting: title, company, contact person, location, remote share, start date, duration, skills, and full description. Ideal for freelancers finding gigs and agencies tracking demand.",
"version": "0.1",
"x-build-id": "bIwCq5yggTwgIRMbw"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/alkausari_mujahid~freelancermap-project-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-alkausari_mujahid-freelancermap-project-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/alkausari_mujahid~freelancermap-project-scraper/runs": {
"post": {
"operationId": "runs-sync-alkausari_mujahid-freelancermap-project-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/alkausari_mujahid~freelancermap-project-scraper/run-sync": {
"post": {
"operationId": "run-sync-alkausari_mujahid-freelancermap-project-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",
"required": [
"startUrls"
],
"properties": {
"startUrls": {
"title": "Search URLs",
"type": "array",
"description": "One or more freelancermap.de project search URLs (each paginated from Start Page to End Page) and/or direct project URLs (https://www.freelancermap.de/projekt/...) to scrape specific postings. Example: https://www.freelancermap.de/projekte",
"default": [
"https://www.freelancermap.de/projekte"
],
"items": {
"type": "string"
}
},
"startPage": {
"title": "Start Page",
"minimum": 1,
"type": "integer",
"description": "First page of search results to scrape (1-based). Pages beyond 1 require account credentials (see below).",
"default": 1
},
"endPage": {
"title": "End Page",
"minimum": 1,
"type": "integer",
"description": "Last page of search results to scrape. Each results page contains up to 28 projects. Pages beyond 1 require account credentials (see below).",
"default": 1
},
"maxItems": {
"title": "Max Items",
"minimum": 1,
"type": "integer",
"description": "Maximum total number of projects to scrape. Useful for quick tests and cost control.",
"default": 10
},
"email": {
"title": "Account Email",
"type": "string",
"description": "Your freelancermap.de login email. Only required when End Page is greater than 1."
},
"password": {
"title": "Account Password",
"type": "string",
"description": "Your freelancermap.de login password. Only required when End Page is greater than 1. Stored securely and never logged."
},
"pageDelay": {
"title": "Page Delay (seconds)",
"minimum": 1,
"maximum": 5,
"type": "integer",
"description": "Delay in seconds to wait on each project page. Increase this if the scraper is being blocked or pages are not fully loading.",
"default": 2
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Proxy settings for the crawler. The Actor works without a proxy by default; enable Apify proxies if you see blocked requests on large runs."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```