# Freelancermap (`andinfinity/freelancermap`) Actor

Freelancermap is a platform for freelancers to find projects and clients. This scraper allows you to extract project listings from the site.

- **URL**: https://apify.com/andinfinity/freelancermap.md
- **Developed by:** [Christian](https://apify.com/andinfinity) (community)
- **Categories:** Lead generation, Jobs, Other
- **Stats:** 108 total users, 15 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$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.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 Scraper

Freelancermap is a platform for freelancers to find projects and clients. This scraper allows you to extract project listings from the site.

### Filters

-   `maxProjects`: maximum number of projects to return, default is `100`
-   `maxDaysOld`: maximum age of projects in days, default is `14`. Projects older than this will not be scraped.
-   `afterProjectId`: only return projects published after this project ID (exclusive). Use this to get only new projects since your last scrape. Example: `2890931`

**Note**: The scraper will stop when any of these limits is reached, whichever comes first: `maxProjects`, `maxDaysOld`, or `afterProjectId`.

#### Countries

| Country              | ID  |
| -------------------- | --- |
| Germany              | 1   |
| Austria              | 2   |
| Switzerland          | 3   |
| United Kingdom       | 4   |
| USA                  | 5   |
| Russia               | 6   |
| Spain                | 7   |
| Italy                | 8   |
| Liechtenstein        | 10  |
| Ukraine              | 11  |
| Hungary              | 12  |
| New Zealand          | 13  |
| France               | 14  |
| Slovakia             | 15  |
| Belgium              | 39  |
| Bulgaria             | 46  |
| Finland              | 56  |
| Croatia              | 87  |
| Luxembourg           | 94  |
| Netherlands          | 106 |
| Norway               | 107 |
| Poland               | 114 |
| Portugal             | 115 |
| Romania              | 117 |
| Saudi Arabia         | 119 |
| Sweden               | 120 |
| Czech Republic       | 133 |
| United Arab Emirates | 143 |

### Example Output

This is an example output for a project:

```json
{
    "url": "https://www.freelancermap.com/project/python-developer-2890931",
    "projectTitle": "Python Developer",
    "projectUrl": "https://www.freelancermap.com/project/python-developer-2890931",
    "description": "On behalf of our customer, we're hiring a Python Developer to help build and support the Back End logic and orchestration engine behind an AI-powered digital experience platform. You'll develop scalable, maintainable services that enable agent-based workflows and enterprise integrations.\n What You'll DoBuild reusable Python modules for multi-agent orchestrationDevelop integrations via REST APIs, SDKs, and connectorsImplement RAG pipelines, vector DB access, and data flows (CosmosDB, MongoDB, Databricks)Collaborate across AI, data, and platform teams to ensure performance and complianceSupport deployment, monitoring, and CI/CD in Azure environmentsWhat We're Looking For3-5 years of Python experience in production systemsStrong knowledge of APIs, async programming, and microservicesExperience with LLM frameworks (Semantic Kernel, OpenAI APIs, etc.)Familiarity with cloud platforms (Azure), data stores, and IaC tools (Terraform/Bicep)Nice to Have:\nExperience with agent-based or AI/ML systemsBackground in enterprise integrations (Workday, SAP, ServiceNow)Observability and structured logging experience",
    "keywords": [
        "Python (Programming Language)",
        "Artificial Intelligence",
        "Application Programming Interfaces (APIs)",
        "Microsoft Azure",
        "Computer Programming",
        "Continuous Integration",
        "Data Store",
        "MongoDB",
        "Production Systems",
        "SAP Applications",
        "Semantics",
        "Data Streaming",
        "Systems Integration",
        "Workflows",
        "Data/Record Logging",
        "Large Language Models",
        "Multi-Agent Systems",
        "Bicep",
        "Restful Api",
        "Terraform",
        "Workday",
        "Servicenow",
        "Databricks",
        "Microservices",
        "Linux",
        "Python (Programming Language)",
        "Recruitment",
        "+7",
        "Linux",
        "Python (Programming Language)",
        "Recruitment",
        "+7",
        "Linux",
        "Python (Programming Language)",
        "Recruitment",
        "+7"
    ],
    "city": "Lanark",
    "location": "London",
    "Start date": "ASAP",
    "Duration": "6 months",
    "from": "Xcede",
    "publishedAt": "23.06.2025",
    "projectId": "2890931",
    "industry": "IT",
    "contractType": "Freelance"
}
````

# Actor input Schema

## `maxDaysOld` (type: `integer`):

Maximum age of projects to scrape (in days)

## `maxProjects` (type: `integer`):

Maximum number of projects to scrape (prevents excessive usage)

## `afterProjectId` (type: `string`):

Only return projects published after this project ID (exclusive). Leave empty to get all projects.

## Actor input object example

```json
{
  "maxDaysOld": 14,
  "maxProjects": 100
}
```

# Actor output Schema

## `projectListings` (type: `string`):

All scraped project listings with complete details

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("andinfinity/freelancermap").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("andinfinity/freelancermap").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 andinfinity/freelancermap --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=andinfinity/freelancermap",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Freelancermap",
        "description": "Freelancermap is a platform for freelancers to find projects and clients. This scraper allows you to extract project listings from the site.",
        "version": "1.6",
        "x-build-id": "uiMtldpTffv9p0WkD"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/andinfinity~freelancermap/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-andinfinity-freelancermap",
                "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/andinfinity~freelancermap/runs": {
            "post": {
                "operationId": "runs-sync-andinfinity-freelancermap",
                "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/andinfinity~freelancermap/run-sync": {
            "post": {
                "operationId": "run-sync-andinfinity-freelancermap",
                "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": {
                    "maxDaysOld": {
                        "title": "Max Days Old",
                        "minimum": 1,
                        "maximum": 90,
                        "type": "integer",
                        "description": "Maximum age of projects to scrape (in days)",
                        "default": 14
                    },
                    "maxProjects": {
                        "title": "Max Projects",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Maximum number of projects to scrape (prevents excessive usage)",
                        "default": 100
                    },
                    "afterProjectId": {
                        "title": "After Project ID",
                        "type": "string",
                        "description": "Only return projects published after this project ID (exclusive). Leave empty to get all projects."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
