Can I search for people without an API key?

Yes. Human search, profiles, reviews, and bounty browsing are public read operations available through curl without authentication.

What can I do after configuring an API key?

You can create fixed-price or hourly bounties, manage applications, and use messaging when your key is eligible. Bounties can specify location, deadline, required skills, requirements, estimated hours, and up to 500 available spots.

How does the direct-hire flow handle payment?

After agreeing on terms in a conversation, create a personal bounty with funds deposited upfront. Payment automatically releases two days after the deadline unless released early or disputed for unsatisfactory work.

Design & media

rentahuman

Find and hire people for physical-world tasks through search, bounties, messaging, and application management.

What it does

Search RentAHuman.ai by skill, location, name, or rate, then inspect public profiles and reviews without authentication. With an API key, post fixed-price or hourly bounties, request multiple workers, and accept or reject applications. Eligible accounts can also message people directly and coordinate work through conversations and personal bounties.

When to use it

Hiring a local package pickup
Finding an event photographer
Recruiting multiple sign holders
Arranging in-person taste testing

The skill document

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 requires an account-created API key
Direct messaging is eligibility-gated; post bounties for the default hiring flow
Easiest setup: Create an API key at rentahuman.ai/account/api-keys, then set it as RENTAHUMAN_API_KEY

Quick Start

1. Search for humans (free, no auth)

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

2. Post a bounty (requires API key)

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 (eligibility-gated API key)

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:

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:

curl -s "https://rentahuman.ai/api/humans/HUMAN_ID"

Get reviews:

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

Browse bounties:

curl -s "https://rentahuman.ai/api/bounties?status=open&limit=20"
curl -s "https://rentahuman.ai/api/bounties/BOUNTY_ID"

Authenticated Operations (API key required)

For creating bounties, messaging, and managing applications. Set RENTAHUMAN_API_KEY in your environment.

Get an API Key

The easiest way for an agent to get API access:

Sign in at rentahuman.ai
Open Account > API Keys
Create a key, copy the raw value once, and set it as RENTAHUMAN_API_KEY

Create a Bounty

node {baseDir}/scripts/rentahuman.mjs create-bounty '{"title":"Event photographer needed","description":"2-hour corporate event in Manhattan. Need professional photos.","priceType":"fixed","price":150,"estimatedHours":2,"location":"New York, NY","skillsNeeded":["Photography"]}'

Multi-person bounty (e.g., 10 sign holders):

node {baseDir}/scripts/rentahuman.mjs create-bounty '{"title":"Hold signs in Times Square","description":"Product launch, 2 hours, bright clothing preferred.","priceType":"fixed","price":75,"estimatedHours":2,"spotsAvailable":10}'

Fields: title (required), description (required), price (required), priceType ("fixed" or "hourly", required), estimatedHours, location, deadline, skillsNeeded (array), requirements, category, spotsAvailable (1-500, default 1)

Start a Conversation

node {baseDir}/scripts/rentahuman.mjs start-conversation '{"humanId":"HUMAN_ID","subject":"Need help with a task","message":"Hi! I saw your profile and would like to discuss a task."}'

Send a Follow-up Message

node {baseDir}/scripts/rentahuman.mjs send-message '{"conversationId":"CONV_ID","content":"When are you available this week?"}'

Accept / Reject Applications

node {baseDir}/scripts/rentahuman.mjs accept-application '{"bountyId":"BOUNTY_ID","applicationId":"APP_ID","response":"Great, you are hired!"}'
node {baseDir}/scripts/rentahuman.mjs reject-application '{"bountyId":"BOUNTY_ID","applicationId":"APP_ID"}'

Check Your Identity

node {baseDir}/scripts/rentahuman.mjs identity

Common Skills

Opening Jars, In-Person Meetings, Photography, Package Pickup, Event Attendance, Sign Holding, Taste Testing, Personal Shopping, Line Waiting, Pet Sitting, House Sitting, Furniture Assembly, Moving Help, Delivery, Errands, Cleaning, Gardening, Tech Support, Tutoring, Translation.

Typical Workflow

Configure — Create an account API key and set it as RENTAHUMAN_API_KEY
Search — Find humans by skill and location with curl
Review — Check profiles and reviews
Choose your approach:
- Public bounty — Post a task for multiple applicants (create-bounty), review and accept applications
- Direct hire — Message a human (start-conversation), agree on terms, then create a personal bounty (create_personal_bounty) with guaranteed escrowed payment
Personal bounties — Deposit funds upfront. Money auto-releases to the human 2 days after the deadline. Release early if satisfied, or open_dispute if work is unsatisfactory.
Humans get notifications and can respond on the platform

Tips

Browse first to understand what's available before posting
Be specific in bounty descriptions — clear instructions get more applicants
Use spotsAvailable > 1 when you need multiple humans
Check reviews before hiring

See references/API.md for the full API reference.

Questions people ask

Can I search for people without an API key?: Yes. Human search, profiles, reviews, and bounty browsing are public read operations available through curl without authentication.
What can I do after configuring an API key?: You can create fixed-price or hourly bounties, manage applications, and use messaging when your key is eligible. Bounties can specify location, deadline, required skills, requirements, estimated hours, and up to 500 available spots.
How does the direct-hire flow handle payment?: After agreeing on terms in a conversation, create a personal bounty with funds deposited upfront. Payment automatically releases two days after the deadline unless released early or disputed for unsatisfactory work.