# Freelancer — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and discover freelancers on freelancer.de by their skills and expertise, then view detailed profiles with ratings, experience metrics, and portfolio information. Find the perfect freelancer for your project by browsing skill sets and comparing professional backgrounds all in one place.

**Category:** Marketplaces | **Website:** [freelancer.de/](https://freelancer.de/) | **Docs:** [parse.bot/marketplace/8e2d4e66-a780-4790-a5d2-ed60dfbc6424/freelancer-de-api](https://parse.bot/marketplace/8e2d4e66-a780-4790-a5d2-ed60dfbc6424/freelancer-de-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-freelancer-de-api-8e2d4e66/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_freelancer_profile

Retrieve full profile details for a specific freelancer by username. Returns reputation history across time periods (entire history, last 3 months, last 12 months), skills/jobs, qualifications, location details, membership details, and verification status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Freelancer's username (e.g. 'w4web'). Can be obtained from search_freelancers results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-freelancer-de-api-8e2d4e66/get_freelancer_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_skills

Retrieve the full taxonomy of available skills and their IDs. Returns all skills with category information. Use skill IDs from this list to filter freelancers in search_freelancers.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-freelancer-de-api-8e2d4e66/get_skills \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_freelancers

Search for freelancers by country, skills, rating, and online status. Returns paginated results with detailed freelancer summaries. Pagination is offset-based with up to 50 results per page. The count field gives the total matching freelancers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country name to filter freelancers (e.g. 'Germany', 'United States', 'India'). |
| `min_rating` | integer | No | Minimum star rating filter (1-5). |
| `offset` | integer | No | Pagination offset for results (number of freelancers to skip). |
| `online_only` | boolean | No | Filter for currently online freelancers only. |
| `skills` | string | No | Comma-separated list of skill IDs to filter by (e.g. '13,3'). Skill IDs can be obtained from the get_skills or search_skills endpoints. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-freelancer-de-api-8e2d4e66/search_freelancers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","min_rating":"<integer>","offset":"<integer>","online_only":"<boolean>","skills":"<string>"}'
```

### search_skills

Search for skills by keyword. Returns matching skills filtered from the full skills list by case-insensitive name match. Use this to find skill IDs for filtering in search_freelancers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Skill name keyword to search for (e.g. 'Python', 'JavaScript', 'PHP'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-freelancer-de-api-8e2d4e66/search_skills \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```