# PeoplePerHour Freelance Jobs API

> Freelance jobs on PeoplePerHour, with title, description, posting date, proposal count, client name and rating, and job link.

- Page: https://cleanedweb.com/catalog/peopleperhour-freelance-jobs-api/
- Contract (JSON): https://cleanedweb.com/catalog/peopleperhour-freelance-jobs-api/contract.json
- Source: peopleperhour.com (https://www.peopleperhour.com/)
- Category: Commerce
- Updated: 2026-11-15

A run reads until the source ends or your `max_items`, `timeout_seconds` or budget stops it.

## Key fields

| Field | Type | Sample value |
| --- | --- | --- |
| `title` | string | `Design 285 simple vector sign shapes, motifs & borders (SVG/DXF)` |
| `description` | string | `I run HomeSigns.uk, a small UK business making personalised house, gate and roo…` |
| `date` | string | `2026-11-14` |
| `url` | string | `https://www.peopleperhour.com/freelance-jobs/design/graphic-design/design-285-simple-vector-sign-shapes-motifs-borders-svg-4531059` |
| `author_name` | string | `Ken S.` |
| `author_profile_url` | string | `https://www.peopleperhour.com/freelancer/marketing-seo/ken-sayer-b2b-contact-finder-zmjmx` |
| `nano` | array of string | `18 proposals, Remote` |
| `record_tags` | string | `featured opportunity` |

Sample values come from one saved record, not a live run. Every field with its type, and the schemas, are in https://cleanedweb.com/catalog/peopleperhour-freelance-jobs-api/contract.json

## Inputs

- `location` (boolean): Filters by the site's location control.
- `pricing` (string): Optional. Filters by the site's pricing control. Options: Fixed 458 (fixed_price), Per Hour 86 (hourly).
- `experiencelevel` (string \| number): Optional. Filters by the site's experiencelevel control. Options: Entry ($) 218 (1), Intermediate ($$) 59 (2), Expert ($$$) 279 (3).
- `jobtype` (string): Optional. Filters by the site's jobtype control. Options: Urgent 7 (urgent), Opportunity 138 (highValue).
- `category` (string): Optional. Free text: any category the site serves, written with letters and hyphens, up to 48 characters. A name the site does not serve is refused with input_value_unverified. Leave it out for the default listing. For example: artificial-intelligence (AI Services), technology-programming (Technology & Programming), writing-translation (Writing & Translation), design (Design), digital-marketing (Digital Marketing), video-photography (Video, Photo & Image), business (Business), music-audio (Music & Audio), and 2 more in https://cleanedweb.com/catalog/peopleperhour-freelance-jobs-api/contract.json. Pattern: `^[A-Za-z][A-Za-z\-]{0,47}$`.
- `sort` (string): Order of the collection, as the site's own sort control offers it; omitted keeps the site's default order. Options: Popularity (popularity), Ending Soon (ending), Budget (budget).

`enrich_records` is on by default and adds the fields that only appear on each record's detail page. Send `false` to read list fields only. See https://cleanedweb.com/docs/run-api/

## Request

`POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_10d258ade87f41daf26d17bc/endpoints/generated_10d258ade87f41daf26d17bc_search/run`

```bash
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_10d258ade87f41daf26d17bc/endpoints/generated_10d258ade87f41daf26d17bc_search/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "pricing": "fixed_price"
  },
  "version": 1,
  "max_items": 25
}'
```

Send an `Idempotency-Key` header with every run and save it before you send. Reuse it only to retry the same request. If the run does not end within `wait_seconds`, read the result with the same API key and key:

`GET https://api.cleanedweb.com/v1/catalog/public/apis/generated_10d258ade87f41daf26d17bc/endpoints/generated_10d258ade87f41daf26d17bc_search/result`

## Versions

Current: `1.0`. Pin a major with "version": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.

- v1: current, newest minor `1.0`

### Changelog

- `1.0` (major) 2026-11-14

The same changelog, as data, is in https://cleanedweb.com/catalog/peopleperhour-freelance-jobs-api/contract.json

## Use it from an AI agent

MCP server: https://api.cleanedweb.com/mcp?profile=catalog (Streamable HTTP). Sign in with a CleanedWeb account when the client asks (OAuth), or send an API key with the `read` and `run` scopes as `Authorization: Bearer`. Call `get_api` with `api_id` `generated_10d258ade87f41daf26d17bc`, then `run_api` with the `run_with` arguments it returns. See https://cleanedweb.com/docs/mcp/

## Run it

Reading the catalog needs no credential. Running needs a CleanedWeb account and an API key with the `run` scope; the first 5,000 records are free, then $1 per 1,000 records. See https://cleanedweb.com/docs/run-catalog-api/

CleanedWeb is not affiliated with www.peopleperhour.com.
