# Freelancer.com Project Search API Documentation

`GET /api/freelancer/projects` returns public projects. `query` searches titles. `project_type` accepts `fixed` or `hourly` and is checked on the returned rows. `job` is a numeric skill id and is checked against the skills on each row. `country` must be a two-letter code such as `DE`; it is translated to the public country name and sent upstream as `countries[]`, because public project rows carry no country field. `min_budget` keeps a row when its bid average, minimum budget or maximum budget is at least the given amount. `from_time` filters on the posting time, and `match=all` requires every query word. `limit` is clamped to 100 and `page` selects the offset window. No row violates a requested filter, and 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/freelancer-api/freelancer_projects](https://scrappa.co/docs/freelancer-api/freelancer_projects)
- **API group:** Freelancer.com API
- **Endpoint:** `GET https://scrappa.co/api/freelancer/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 | Keywords matched against titles. |
| `project_type` | string | No | fixed or hourly. |
| `job` | integer | No | Numeric skill id. |
| `country` | string | No | Country filter. |
| `min_budget` | number | No | Minimum price signal. |
| `from_time` | integer | No | Unix seconds lower bound. |
| `match` | string | No | all requires every word. |
| `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/projects?query=python&page=1"
```

## Example response

```json
{
    "success": true,
    "data": {
        "projects": [
            {
                "id": 40826196,
                "owner_id": 12345678,
                "title": "Python developer for data pipeline",
                "url": "https://www.freelancer.com/projects/python-data-pipeline",
                "type": "fixed",
                "budget": {
                    "minimum": 500,
                    "maximum": 1000,
                    "currency": {
                        "code": "USD",
                        "sign": "$"
                    }
                },
                "bid_stats": {
                    "bid_count": 12,
                    "bid_avg": 750
                },
                "jobs": [
                    {
                        "id": 3,
                        "name": "Python",
                        "category": 1
                    }
                ],
                "description": "We need a Python developer.",
                "posted_at": "2026-11-19T10:00:00Z",
                "updated_at": "2026-11-19T11:00:00Z"
            }
        ],
        "pagination": {
            "page": 1,
            "per_page": 10,
            "has_more": true,
            "total": 140
        }
    },
    "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)
