API reference

Coming soon

Read the catalogue, manage your own orders and downloads. Seller write access — creating and updating listings — lives in the dashboard, not the public API.

Quickstart

curl https://api.marketplace.dev/v1/products?category=templates \
  -H "Authorization: Bearer sk_live_51H...

{
  "data": [
    { "id": "1", "title": "Dashboard UI Kit", "price": 49, "seller": "pixelforge" },
    { "id": "3", "title": "Line Icon Pack (900)", "price": 19, "seller": "pixelforge" }
  ],
  "next_cursor": "eyJpZCI6IjMifQ=="
}

Endpoints

MethodPathDoes
GET/v1/productsSearch and list products
GET/v1/products/:idProduct detail with licence tiers
GET/v1/sellers/:idSeller profile and catalogue
GET/v1/ordersYour orders and download links
POST/v1/downloads/:id/linkMint a fresh download link
POST/v1/webhooksSubscribe to sale, refund, review events

Authentication

Every request needs a bearer token: Authorization: Bearer sk_live_…. Generate keys from Seller dashboard → API docs, scoped to read-only or read-write, and rotate them anytime — the old key keeps working for 24 hours so nothing breaks mid-deploy.

Scopes
products:read, orders:read, downloads:write, webhooks:write
Key rotation
Old key valid for 24h after a new one is issued
Test mode
sk_test_ keys hit a sandboxed catalogue

Rate limits

600 requests per minute per key. Responses include X-RateLimit-Remaining; exceeding the limit returns 429 with a Retry-After header in seconds.

Webhooks

Subscribe an HTTPS endpoint to receive events as they happen. Every payload is signed with your webhook secret in the X-Signature header — verify it before trusting the body.

sale.completedsale.refundedreview.createdpayout.sent

SDKs

JavaScript

npm install @marketplace/sdk

Python

pip install marketplace-sdk

PHP

composer require marketplace/sdk

Go

go get github.com/marketplace/sdk-go