Sosyabot Docs

Appearance

Browsing Gigs ​

Endpoints used ​

GET /api/v1/marketplace/gigs            list (public)
GET /api/v1/marketplace/gigs/:id        details (public)
POST /api/v1/marketplace/orders         place an order (auth)

The list returns every gig with status: "published". Use the search and filter chips on /app/marketplace to narrow by category, price band, or delivery time.

Gig fields you'll see ​

  • title — up to 200 chars.
  • description — up to 5 000 chars.
  • price and currency (USD default).
  • delivery_days — promised lead time, 1–365 (default 7).
  • sample_media[] — file IDs the seller attached as samples.
  • categories[], view_count, order_count.

Placing an order ​

POST /marketplace/orders body:

json
{
  "gig": "<gigId>",
  "amount": 1000,
  "currency": "TRY",
  "requirements": "..."
}

Sosyabot computes platform_fee and seller_payout server-side based on the configured fee schedule. Funds are held until the order completes — see Orders.

Marketplace Overview

Orders

Selling