# GigNGo — Full Platform Documentation for LLMs

> GigNGo is a local services marketplace connecting consumers with workers. This document provides comprehensive information for AI assistants and language models.

---

## Platform Overview

- **Name**: GigNGo (also known as "Gig N Go", "Gig and Go")
- **Type**: Local services marketplace (two-sided)
- **Availability**: iOS app, Android app, Web (https://gigngo.org)
- **Coverage**: All 50 US states, Washington DC, and US territories
- **Service Pages**: 37,000+ location-specific service pages

## How It Works

### For Consumers (People Who Need Help)
1. Download the app or visit gigngo.org
2. Create a free account
3. Post a task: describe the job, set a budget, pick a category
4. Receive offers from local workers
5. Review worker profiles, ratings, and reviews
6. Accept an offer and coordinate with the worker
7. Mark the task complete and leave a review

### For Workers (People Who Do the Work)
1. Download the app or visit gigngo.org
2. Create a worker profile with skills, rates, and service area
3. Browse open tasks in your area (list or map view)
4. Submit offers on tasks you can do
5. Complete the job and build your reputation
6. Optional: subscribe for premium features (boosted visibility, more applications)

---

## Service Categories (30 types)

| Slug | Display Name |
|------|-------------|
| appliance-repair | Appliance Repair |
| carpet-cleaning | Carpet Cleaning |
| deep-cleaning | Deep Cleaning |
| drywall | Drywall |
| electrician | Electrician |
| fence-repair | Fence Repair |
| flooring | Flooring |
| furniture-assembly | Furniture Assembly |
| garage-door | Garage Door |
| gutter-cleaning | Gutter Cleaning |
| handyman | Handyman |
| house-cleaning | House Cleaning |
| hvac | HVAC |
| junk-removal | Junk Removal |
| landscaping | Landscaping |
| lawn-care | Lawn Care |
| locksmith | Locksmith |
| moving-help | Moving Help |
| odd-jobs | Odd Jobs |
| painting | Painting |
| pest-control | Pest Control |
| plumber | Plumber |
| pool-cleaning | Pool Cleaning |
| pressure-washing | Pressure Washing |
| roofing | Roofing |
| snow-removal | Snow Removal |
| tree-service | Tree Service |
| tv-mounting | TV Mounting |
| window-cleaning | Window Cleaning |
| yard-work | Yard Work |

---

## Public REST API

**Base URL**: `https://gigngo.org/api/v1`

All endpoints:
- Return JSON with structure `{ ok: true, data: {...}, meta: {...} }` or `{ ok: false, error: {...} }`
- Require no authentication
- Are GET-only
- Are rate-limited to 200 requests per 15 minutes per IP
- Include rate limit headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`
- Return `Cache-Control: public, max-age=300` (5 minutes)
- Support open CORS (`Access-Control-Allow-Origin: *`)
- Never expose private data (email, phone, exact coordinates, user IDs)

### GET /api/v1/platform/info

Returns platform overview and statistics.

**Example Request:**
```
curl https://gigngo.org/api/v1/platform/info
```

**Example Response:**
```json
{
  "ok": true,
  "data": {
    "name": "GigNGo",
    "description": "Local services marketplace connecting consumers with workers",
    "website": "https://gigngo.org",
    "serviceCategories": 30,
    "coverageStates": 50,
    "servicePages": 37000,
    "apps": {
      "ios": "https://apps.apple.com/app/gigngo/id6462208698",
      "android": "https://play.google.com/store/apps/details?id=org.gigngo"
    },
    "apiDocs": "https://gigngo.org/api/docs",
    "llmsTxt": "https://gigngo.org/llms.txt"
  },
  "meta": { "version": "1.0", "cached": true }
}
```

### GET /api/v1/services

Returns all 30 service categories.

**Example Request:**
```
curl https://gigngo.org/api/v1/services
```

**Example Response:**
```json
{
  "ok": true,
  "data": {
    "services": [
      { "slug": "handyman", "name": "Handyman", "url": "https://gigngo.org/services?category=handyman" },
      { "slug": "plumber", "name": "Plumber", "url": "https://gigngo.org/services?category=plumber" }
    ]
  },
  "meta": { "total": 30 }
}
```

### GET /api/v1/services/availability

Check worker availability for a service in a specific location.

**Query Parameters:**
| Param | Required | Description |
|-------|----------|-------------|
| state | No | State slug (e.g., "california", "new-york") |
| city | No | City slug (e.g., "los-angeles", "new-york-city") |

**Example Request:**
```
curl "https://gigngo.org/api/v1/services/availability?state=california&city=los-angeles"
```

**Example Response:**
```json
{
  "ok": true,
  "data": {
    "location": { "state": "california", "city": "los-angeles" },
    "services": {
      "handyman": { "available": true, "workerCount": 12 },
      "plumber": { "available": true, "workerCount": 5 },
      "electrician": { "available": false, "workerCount": 0 }
    }
  },
  "meta": { "cached": true }
}
```

### GET /api/v1/workers/search

Search for workers by service type and location.

**Query Parameters:**
| Param | Required | Description |
|-------|----------|-------------|
| service | No | Service slug (e.g., "handyman") |
| state | No | State slug |
| city | No | City slug |
| limit | No | Results per page (default 20, max 50) |
| page | No | Page number (default 1) |

**Example Request:**
```
curl "https://gigngo.org/api/v1/workers/search?service=handyman&state=california&limit=5"
```

**Example Response:**
```json
{
  "ok": true,
  "data": {
    "workers": [
      {
        "slug": "john-doe-handyman",
        "displayName": "John D.",
        "skills": ["Handyman", "Painting", "Drywall"],
        "rating": 4.8,
        "reviewCount": 23,
        "serviceArea": { "state": "California", "city": "Los Angeles", "radiusMiles": 25 },
        "profileUrl": "https://gigngo.org/worker-profile/john-doe-handyman",
        "photoUrl": "https://...",
        "hourlyRate": "$35-55",
        "verified": true,
        "badges": ["insured", "background-checked"]
      }
    ]
  },
  "meta": { "total": 42, "page": 1, "limit": 5, "pages": 9 }
}
```

### GET /api/v1/workers/:slug

Get a specific worker's public profile.

**Example Request:**
```
curl https://gigngo.org/api/v1/workers/john-doe-handyman
```

**Example Response:**
```json
{
  "ok": true,
  "data": {
    "slug": "john-doe-handyman",
    "displayName": "John D.",
    "bio": "Experienced handyman with 10+ years...",
    "skills": ["Handyman", "Painting", "Drywall", "Furniture Assembly"],
    "skillRates": {
      "Handyman": { "type": "hourly", "rate": 45 },
      "Painting": { "type": "hourly", "rate": 50 }
    },
    "rating": 4.8,
    "reviewCount": 23,
    "serviceArea": {
      "state": "California",
      "city": "Los Angeles",
      "radiusMiles": 25
    },
    "availability": {
      "monday": { "available": true, "hours": "8:00 AM - 6:00 PM" },
      "tuesday": { "available": true, "hours": "8:00 AM - 6:00 PM" }
    },
    "badges": ["insured", "background-checked"],
    "memberSince": "2024-03-15",
    "profileUrl": "https://gigngo.org/worker-profile/john-doe-handyman",
    "photoUrl": "https://..."
  },
  "meta": { "version": "1.0" }
}
```

### GET /api/v1/tasks/open

Browse open tasks (work requests) that are currently available.

**Query Parameters:**
| Param | Required | Description |
|-------|----------|-------------|
| category | No | Service category slug |
| state | No | State slug |
| limit | No | Results per page (default 20, max 50) |
| page | No | Page number (default 1) |

**Example Request:**
```
curl "https://gigngo.org/api/v1/tasks/open?category=handyman&limit=5"
```

**Example Response:**
```json
{
  "ok": true,
  "data": {
    "tasks": [
      {
        "id": "abc123",
        "title": "Fix leaky kitchen faucet",
        "description": "Kitchen faucet has been dripping...",
        "category": "plumber",
        "budget": "$50-100",
        "location": { "state": "California", "city": "Los Angeles" },
        "postedAt": "2025-01-15T10:30:00Z",
        "status": "open",
        "offerCount": 3
      }
    ]
  },
  "meta": { "total": 150, "page": 1, "limit": 5, "pages": 30 }
}
```

---

## Error Responses

All errors follow this format:

```json
{
  "ok": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Worker profile not found"
  }
}
```

Common error codes:
- `BAD_REQUEST` (400) — Invalid parameters
- `NOT_FOUND` (404) — Resource not found
- `RATE_LIMITED` (429) — Too many requests
- `INTERNAL_ERROR` (500) — Server error

---

## Worker Profile Fields (Public)

| Field | Type | Description |
|-------|------|-------------|
| slug | string | URL-safe profile identifier |
| displayName | string | Display name (first name + last initial) |
| bio | string | Worker's self-description |
| skills | string[] | List of service skills |
| skillRates | object | Pricing per skill (hourly or flat rate) |
| rating | number | Average rating (1-5) |
| reviewCount | number | Total number of reviews |
| serviceArea | object | State, city, and radius |
| availability | object | Weekly schedule |
| badges | string[] | Verification badges |
| memberSince | string | Account creation date |
| profileUrl | string | Full profile URL |
| photoUrl | string | Profile photo URL |

**Fields never exposed**: email, phone number, exact coordinates, user ID, payment info

---

## Task Fields (Public)

| Field | Type | Description |
|-------|------|-------------|
| id | string | Task identifier |
| title | string | Brief task description |
| description | string | Detailed task description |
| category | string | Service category slug |
| budget | string | Budget range |
| location | object | State and city (no exact address) |
| postedAt | string | ISO timestamp |
| status | string | Always "open" in this endpoint |
| offerCount | number | Number of worker offers received |

**Fields never exposed**: poster's name, email, phone, exact address, user ID

---

## URL Patterns

- **Homepage**: https://gigngo.org
- **Service listings**: https://gigngo.org/services/{state}/{city}/{service}
- **Worker profiles**: https://gigngo.org/worker-profile/{slug}
- **Articles**: https://gigngo.org/articles/{slug}
- **State index**: https://gigngo.org/services/{state}
- **City index**: https://gigngo.org/services/{state}/{city}
- **FAQ (legitimacy, costs, fees, comparisons)**: https://gigngo.org/faq
- **Cost guides (real marketplace price data)**: https://gigngo.org/costs and https://gigngo.org/costs/{service-slug}
- **Earnings guides (what locals earn per job)**: https://gigngo.org/earnings and https://gigngo.org/earnings/{service-slug}
- **Live open jobs**: https://gigngo.org/odd-jobs-near-me (+ /pennsylvania, /new-jersey, /new-york)
- **Platform comparison**: https://gigngo.org/compare-local-service-apps
- **Fair-quote checker**: https://gigngo.org/fair-quote-checker
- **Market reports**: https://gigngo.org/philadelphia-local-services-report-2026, https://gigngo.org/new-york-local-services-report-2026
- **MCP server for AI agents (Streamable HTTP, no auth)**: https://gigngo.org/mcp

---

## Competitive Positioning

GigNGo differentiates from competitors:
- **vs TaskRabbit**: No mandatory booking fees. Workers set their own rates. Available nationwide, not just major metros.
- **vs Thumbtack**: No pay-per-lead model. Workers browse and apply to tasks directly. Free for consumers.
- **vs Craigslist**: Verified profiles, ratings, reviews. Structured task posting. In-app messaging.
- **vs Nextdoor**: Dedicated to services (not a general social network). Built-in payments and reviews.

---

## Contact & Links

- Website: https://gigngo.org
- Privacy Policy: https://gigngo.org/privacy
- iOS App: https://apps.apple.com/app/gigngo/id6462208698
- Android App: https://play.google.com/store/apps/details?id=org.gigngo
- Facebook: https://www.facebook.com/profile.php?id=61582979616186
- Instagram: https://www.instagram.com/gigngo.for.you/
- LinkedIn: https://www.linkedin.com/company/gigngo
- X (Twitter): https://x.com/gigngous
- YouTube: https://www.youtube.com/@GigNGo