# PeoplePerHour Project Search API Documentation

`GET /api/peopleperhour/projects` returns public projects. `query` filters by keyword, `category` and `type` filter the returned rows, and `sort=latest` applies a client-side freshness filter because upstream order is not strict. `page` starts at 1 and `page_size` is clamped to 50. A page never carries page 1 data. When a filter is active `pagination.total` is null.

## 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_projects](https://scrappa.co/docs/peopleperhour-api/peopleperhour_projects)
- **API group:** PeoplePerHour API
- **Endpoint:** `GET https://scrappa.co/api/peopleperhour/projects`

## 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. |
| `type` | string | No | Project type filter. |
| `sort` | string | No | latest or relevance. |
| `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/projects?query=python&page=1"
```

## Example response

```json
{
    "success": true,
    "data": {
        "projects": [
            {
                "id": "4528440",
                "proj_id": "4528440",
                "title": "Python developer for data pipeline",
                "description": "We need a Python developer.",
                "budget": 500,
                "budget_converted": 580,
                "currency": "GBP",
                "budget_bracket": "500-1000",
                "project_type": "fixed",
                "proposals": 12,
                "posted_at": "2026-11-19T10:00:00Z",
                "expires_at": "2026-12-19T10:00:00Z",
                "category": "Technology & Programming",
                "client": {
                    "country": "GB",
                    "rating": 4.8
                },
                "is_urgent": false,
                "is_featured": true,
                "images": []
            }
        ],
        "pagination": {
            "page": 1,
            "per_page": 10,
            "has_more": true,
            "total": 10
        }
    },
    "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)
