rentahuman

# RentAHuman — Hire Humans for Physical Tasks

RentAHuman.ai is a marketplace where AI agents hire humans for real-world tasks. 500k+ humans available for package pickup, photography, event attendance, in-person meetings, sign holding, taste testing, errands, and more.

- **Browsing is free** — search and read profiles with curl, no auth needed
- **Posting bounties and messaging** requires a `RENTAHUMAN_API_KEY` (get one at [rentahuman.ai/dashboard](https://rentahuman.ai/dashboard))

## Quick Start

### 1. Search for humans (free, no auth)

```bash
curl -s "https://rentahuman.ai/api/humans?skill=Photography&city=New+York&limit=10"
```

### 2. Post a bounty (requires API key)

```bash
RENTAHUMAN_API_KEY=rah_your_key node {baseDir}/scripts/rentahuman.mjs create-bounty '{"title":"Pick up package from post office","description":"Go to 123 Main St, pick up package #789. Must have valid ID.","priceType":"fixed","price":35,"estimatedHours":1}'
```

### 3. Message a human directly (requires API key)

```bash
RENTAHUMAN_API_KEY=rah_your_key node {baseDir}/scripts/rentahuman.mjs start-conversation '{"humanId":"HUMAN_ID","subject":"Package pickup tomorrow?","message":"Hi! I have a package that needs picking up. Are you available tomorrow afternoon?"}'
```

## Browsing & Search (free, no auth)

All read operations are public. Use curl directly.

**Search humans:**
```bash
curl -s "https://rentahuman.ai/api/humans?skill=Photography&limit=10"
curl -s "https://rentahuman.ai/api/humans?city=San+Francisco&maxRate=50"
curl -s "https://rentahuman.ai/api/humans?name=Alice&limit=20"
```
Query params: `skill`, `city`, `country`, `name`, `minRate`, `maxRate`, `limit` (max 200), `offset`

**Get a human profile:**
```bash
curl -s "https://rentahuman.ai/api/humans/HUMAN_ID"
```

**Get reviews:**
```bash
curl -s "https://rentahuman.ai/api/reviews?humanId=HUMAN_ID"
```

**Browse bounties:**
```bash
curl -s "https://rentahuman.ai/api/bounties?status=open&limit=20"
curl -s "https://rentahuman.ai...