---
title: "Search for workers"
method: GET
path: "/workers/search"
tags: ["Workers"]
---

# Search for workers

`GET /workers/search`

## Request

- Base URL: `https://gigngo.org/api/v1`
- URL: `https://gigngo.org/api/v1/workers/search`
- Auth: none declared

Search for workers by service type and location. Returns paginated results sorted by rating.

## Query parameters

- `service` string
- `state` string
- `city` string
- `limit` integer
- `page` integer

## Response `200`

Worker search results

- WorkerSearchResponse
  - `ok` boolean
  - `data` object
    - `workers` WorkerSummary[]
      - `slug` string
      - `displayName` string
      - `skills` string[]
      - `rating` number, nullable
      - `reviewCount` integer
      - `serviceArea` object
        - `state` string, nullable
        - `city` string, nullable
        - `radiusMiles` number, nullable
      - `badges` string[]
      - `verified` boolean
      - `profileUrl` string, nullable
      - `photoUrl` string, nullable
  - `meta` PaginationMeta
    - `total` integer
    - `page` integer
    - `limit` integer
    - `pages` integer

## Other responses

- `429`: Rate limit exceeded (200 req/15min)
- `500`: Server error

---

[API](https://skmtc.dev/gigngo/apis/gigngo-public-api.md) · [All operations](https://skmtc.dev/gigngo/apis/gigngo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gigngo/apis/gigngo-public-api/revisions/20ef5bb7d13c?raw)