# Freelancer.com Freelancer Search API Documentation

`GET /api/freelancer/freelancers` returns public directory profiles. `query` searches profiles. `job` is a numeric skill id sent upstream as `jobs[]`. `country` must be a two-letter code such as `DE`; it is translated to the public country name, sent upstream as `countries[]` and checked on the returned `country` code when present. `limit` is clamped to 100 and `page` selects the offset window. Hourly rate is a number when exposed, otherwise null. Feedback, skills and country stay null or empty when the public profile does not expose them. Only public profile fields are returned.

## Credits

A successful request costs **1 credit**. Errors and blocks cost nothing. The response shows the charge in `meta.credits_charged`.

- **Documentation:** [https://scrappa.co/docs/freelancer-api/freelancer_freelancers](https://scrappa.co/docs/freelancer-api/freelancer_freelancers)
- **API group:** Freelancer.com API
- **Endpoint:** `GET https://scrappa.co/api/freelancer/freelancers`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Keywords matched against profiles. |
| `job` | integer | No | Numeric skill id. |
| `country` | string | No | Country filter. |
| `limit` | integer | No | Page size, clamped to 100. |
| `page` | integer | No | Page number, starting at 1. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/freelancer/freelancers?query=python&page=1"
```

## Example response

```json
{
    "success": true,
    "data": {
        "freelancers": [
            {
                "id": 12345678,
                "public_name": "Ada L.",
                "hourly_rate": 45,
                "seller_stats": {
                    "feedback_rating": 4.9,
                    "reviews": 88,
                    "projects_completed": 120
                },
                "skills": [
                    "Python"
                ]
            }
        ],
        "pagination": {
            "page": 1,
            "per_page": 10,
            "has_more": true,
            "total": 117305
        }
    },
    "meta": {
        "credits_charged": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing, unknown or unusable. Unknown parameters are rejected. Non-billable. |
| 503 | Upstream Unavailable | The upstream blocked the request or could not be reached. Non-billable. Clients are never rate limited. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
