# ToucanBid

> ToucanBid (Two Can Bid. Toucan) is a map-based marketplace (now live in Florida; all other states and DC coming soon) where Clients post jobs and Licensed Pros in many licensed professions (trades, design, legal, real estate, health and more) submit bids. Clients post for free.

## For AI assistants and tools

- You may read and summarize public jobs to help Licensed Pros find work.
- Public job data never includes the Client's name, contact details or exact address; only city, state, profession, budget and scope.
- Bidding, messaging Clients and every other write action require a signed-in, paying ToucanBid Licensed Pro account on the website ($9.99/month; the first 3 founding months are free). Clients never pay to post.
- API keys are read-only and can never bid. Send users to each job's signUpToBidUrl to join and bid.

## Public pages

- [Find jobs](http://app.toucanbid.com/jobs): searchable list of open jobs (filters: q, profession, state, near, radius, budget, posted, sort, page)
- [Jobs map](http://app.toucanbid.com/map): U.S. county map of open jobs
- [Job detail](http://app.toucanbid.com/jobs/{id}): one job's public scope and bidding status
- [Find Licensed Pros](http://app.toucanbid.com/pros): directory by state and profession (http://app.toucanbid.com/pros/{state}/{profession})
- [Licensed Pro profiles](http://app.toucanbid.com/pro/{slug}): public profile, licenses on file, reviews
- [Fees](http://app.toucanbid.com/fees) · [How ranking works](http://app.toucanbid.com/how-ranking-works) · [How verification works](http://app.toucanbid.com/how-verification-works)

## API (read-only JSON)

- [Developer docs](http://app.toucanbid.com/developers)
- [OpenAPI spec](http://app.toucanbid.com/api/v1/openapi.json)
- GET http://app.toucanbid.com/api/v1/jobs?q=roof&state=FL&page=1: search open jobs (same filters as /jobs)
- GET http://app.toucanbid.com/api/v1/jobs/{id}: one job
- Each job includes url and signUpToBidUrl.
- Rate limits: anonymous 30 requests/min per IP; with a free API key (header X-API-Key, from http://app.toucanbid.com/developers) 60/min. Abusive clients are blocked.

## Not for crawling

Account, dashboard, admin, posting and all private /api/ endpoints are off-limits (see http://app.toucanbid.com/robots.txt).