# EdgeGigs API

> EdgeGigs is a Fiverr-style marketplace for freelance services, digital products, API
> resellers, and cloud-infrastructure rentals. This file maps the public HTTP API so AI
> agents and developers can browse the catalog and act on a user's behalf programmatically.

Base URL: https://edgegigs.com/api
Machine-readable manifest (OpenAPI 3.1): https://edgegigs.com/api/openapi.json
Content types: all endpoints return JSON unless noted.

## Authentication

Catalog (read) endpoints are public — no auth needed.
Account endpoints act AS A USER and require a personal API key.

- Send the key as a header: `Authorization: Bearer egk_live_…`
- Get a key: sign in at https://edgegigs.com/login, then create/reissue/revoke it at https://edgegigs.com/settings/api-keys
- Keys are shown ONCE on creation. Reissuing (rotating) invalidates the previous key.
- Keys cannot be created or rotated via the API — only from the signed-in browser settings page.

## Catalog endpoints (public, no auth)

- GET /api/health — service health + active gig count.
- GET /api/categories — category list ({ key, label }). Live keys: api, infra, ai, dev, design, video, audio, marketing, writing, knowledge, goods.
- GET /api/gigs — list/search active gigs. Query: category=<key>, q=<text>, sort=best|selling|newest|rating.
- GET /api/gigs/{id} — single gig detail (incl. seller_id, pricing).
- GET /api/sellers — sellers with at least one active gig ({ id, display_name, gig_count }).
- GET /api/sellers/{id} — seller profile + their active gigs.
- GET /api/endpoints?gig=<id> — priced API endpoints for an API-type gig.

## Account endpoints (require Authorization: Bearer <key>)

- GET /api/orders — the authenticated user's orders (newest first).
- GET /api/favorites — the user's saved gigs. ?ids=1 returns just saved gig ids.
- POST /api/favorites { gigId } — save a gig to the wishlist.
- DELETE /api/favorites { gigId } — remove a gig from the wishlist.
- GET /api/credits/balance — the user's prepaid API-credit balance.

## Examples

List gigs in the "ai" category:
  curl "https://edgegigs.com/api/gigs?category=ai&sort=rating"

Get one gig:
  curl "https://edgegigs.com/api/gigs/<gigId>"

List your own orders with an API key:
  curl -H "Authorization: Bearer egk_live_…" "https://edgegigs.com/api/orders"

Save a gig to your wishlist (JS fetch):
  fetch("https://edgegigs.com/api/favorites", {
    method: "POST",
    headers: { "Authorization": "Bearer egk_live_…", "Content-Type": "application/json" },
    body: JSON.stringify({ gigId: "<gigId>" })
  })

## Notes

- Buyer-facing responses expose only safe public fields (never email or internal flags).
- Sensitive write paths (checkout/payouts) are intentionally not part of the agent surface yet.