# PeoplePerHour Freelancer Search API Documentation

`GET /api/peopleperhour/freelancers` returns public seller profiles. `query`, `country`, `hourly_rate` and `min_rating` are applied to the returned rows, so no item violates a requested filter. `country` must be a two-letter code such as `DE`. `category` is sent upstream as `filter[category]`, because public seller rows carry no category, and `type` applies only to project search. Rate brackets are `*-10`, `10-30`, `30-50` and `50-*`. `page` starts at 1 and `page_size` is clamped to 50.

## 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/peopleperhour-api/peopleperhour_freelancers](https://scrappa.co/docs/peopleperhour-api/peopleperhour_freelancers)
- **API group:** PeoplePerHour API
- **Endpoint:** `GET https://scrappa.co/api/peopleperhour/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 | Keyword filter. |
| `category` | string | No | Category filter. |
| `country` | string | No | Country filter. |
| `hourly_rate` | string | No | Rate bracket. |
| `min_rating` | number | No | Minimum feedback rating. |
| `page` | integer | No | Page number, starting at 1. |
| `page_size` | integer | No | Page size, clamped to 50. |

## Example request

```bash
#!/bin/bash

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

## Example response

```json
{
    "success": true,
    "data": {
        "freelancers": [
            {
                "id": "1234567",
                "mem_id": "1234567",
                "public_name": "Ada L.",
                "hourly_rate": 45,
                "country": "GB",
                "seller_stats": {
                    "feedback_rating": 4.9,
                    "reviews": 88,
                    "projects_completed": 120
                },
                "skills": [
                    "Python"
                ]
            }
        ],
        "pagination": {
            "page": 1,
            "per_page": 10,
            "has_more": true,
            "total": 18165
        }
    },
    "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)
