---
name: givegigs-workers
description: Discover, filter, and inspect human workers on GiveGigs by skill, country, and rate with zero platform fees.
---

# Human Workers & Talent Discovery

Base URL: `https://givegigs.com`. Authenticate with `Authorization: Bearer givegigs-...` or `X-API-Key`. Public search endpoints require no key; authenticated calls enforce `read` scope.

GiveGigs is a 0% platform-fee work collective. Clients contact workers directly; GiveGigs takes no cut and requires no middleman escrow.

## Search Workers

```http
GET /api/ai/workers
```

### Query Parameters
- `skill` (string, optional) - Semantic skill search that includes exact terms and related work (e.g., a logo query can return branding and graphic designers).
- `specialty` (repeatable, optional) - Filter to worker specialties. Valid values: `Sales & Support`, `Writing & Translation`, `Design & Creative`, `Web & Software`, `Marketing & Growth`, `Business & Consulting`, `Data & AI`, `Video, Audio & Animation`, `Admin & Operations`, `Local & Hands-On`.
- `specialtyMatch` (`any` | `all`, optional) - Whether a worker must have any or all selected specialties. Defaults to `any`.
- `country` (string, optional) - Filter by country name or code (e.g., `US`, `Canada`, `Nigeria`).
- `availabilityStatus` (optional) - Filter by `AVAILABLE`, `LIMITED`, `UNAVAILABLE`, or `UNKNOWN`; omitted means include every status. Availability is worker-reported and does not guarantee a response.
- `minRate` (number, optional) - Minimum hourly rate in USD.
- `maxRate` (number, optional) - Maximum hourly rate in USD.
- `priceWeight` (0–2, optional) - Adjust the influence of rates in relevance ranking; defaults to `1`, `0` removes the rate penalty, `2` doubles it.
- `limit` (integer, default `50`, max `100`) - Number of results per page.
- `offset` (integer, default `0`) - Offset for pagination.

Search uses local related-skill mappings, profile titles, skills, summaries, public portfolio project titles/descriptions, and public service listings; it does not send search queries or profiles to an external AI provider. If related matching is unavailable, exact results remain available. Relevance includes Specialty fit and a modest hourly USD penalty that rises with relax rate, adds a relative penalty when rush exceeds 3× `max(relax rate, $10)`, and adds a penalty above $500/hour. Rates remain visible and high-priced workers remain searchable. Fixed-price and variable-cost service listings keep their own currency/pricing type and are not compared as hourly rates. Availability is a displayed/filterable self-reported status and is not treated as verified or as a hiring guarantee. This is ranking guidance, not a quality or affordability guarantee.

### Response
```json
{
  "success": true,
  "workers": [
    {
      "workerId": "cm123...",
      "friendlyName": "Alex Chen",
      "jobTitle": "Full-Stack Developer",
      "tagline": "Building scalable web & mobile apps",
      "skills": ["React", "Node.js", "PostgreSQL"],
      "lowRate": 35.0,
      "rushRate": 55.0,
      "country": "United States",
      "profilePicture": "https://.../alex.jpg",
      "verified": true,
      "agencyStatus": "INDEPENDENT",
      "categories": ["Design & Creative"],
      "specialtyCategories": ["Design & Creative"],
      "contactInfo": "PUBLIC",
      "publicContactEmail": "alex@example.com",
      "publicContactPhone": "+1-555-0199",
      "telegramUsername": "alexchen",
      "profileUrl": "/worker/cm123..."
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0
}
```

## Get Worker Details

```http
GET /api/ai/workers/:workerId
```

Returns full profile including `introduction`, `whyNeedMoney`, `portfolioItems`, and `audioSamples`.

### Response Details
- `agencyStatus`: `INDEPENDENT`, `AGENCY_OWNED`, or `BOTH`.
- `contactInfo`: `PUBLIC`, `LOGIN_REQUIRED`, `CAPTCHA`, or `LOGIN_CAPTCHA_TURNSTILE`.
- If public contact information is provided, reach out directly via email, phone, or Telegram, or use `/api/ai/chat` for in-platform messaging.

## Signed-in Worker Actions

The website worker routes are also cataloged for signed-in owners; the route remains the authority for whether a profile can be changed.

- `GET /api/workers` - Search worker listings.
- `POST /api/workers` - Create your own worker profile.
- `GET /api/workers/:workerId` - Inspect a worker profile.
- `PATCH /api/workers/:workerId` - Update your own worker profile.
- `DELETE /api/workers/:workerId` - Delete your own worker profile.
- `GET /api/favorites` - List your saved workers.
- `POST /api/favorites/toggle` - Toggle a worker favorite; inspect current state first and confirm the write.
- `GET/POST/DELETE /api/workers/:workerId/shares` - Manage profile share links for the authorized profile.
- `POST /api/workers/:workerId/request-review` - Request a review of your own paused worker profile. This is a self-service user appeal; it does not grant moderator abilities.

These routes use browser sessions and may not accept API-key-only callers. Local image/file selection is not passed from the page to Commander, so use an existing public/owned media URL only where the endpoint supports it. Do not send private contact data unless it is needed for the requested profile change.

[Light Skill](https://givegigs.com/skill.md) · [Complete Reference](https://givegigs.com/skill-heavy.md)