API Documentation

Integrate SH SMM Panel into your app. Full REST API with webhooks and SDKs.

Authentication

All API requests require an API key. Include it in the header:

Authorization: Bearer YOUR_API_KEY

Get your API key from Settings → API Keys in the dashboard.

Core Endpoints

Orders

POST /api/orders/create

Place a new order

{ "reel_url": "https://instagram.com/reel/ABC123/", "target_views": 10000, "delivery_curve": "organic", "panel_id": "panel_1", "priority": 1 }

GET /api/orders/{id}

Get order status and delivery progress

POST /api/orders/bulk

Place multiple orders in one request (CSV upload)

POST /api/orders/{id}/cancel

Cancel a pending order

Panels

GET /api/panel-config/panels

List all connected panels

POST /api/panel-config/panels/add

Add a new SMM panel

{ "name": "SMMKings", "api_url": "https://api.smmkings.com", "api_key": "your_key", "priority": 1 }

GET /api/panel-config/balances

Get live balance for all panels

Delivery Curves

GET /api/curve/templates

Get available curve templates

POST /api/curve/create

Create custom delivery curve

{ "name": "Fast Viral", "warmup_hours": 1, "peak_hours": 6, "peak_intensity": 90, "decay_hours": 18 }

Analytics

GET /api/orders/stats

Get order statistics and metrics

GET /api/orders/{id}/delivery-series

Get hourly delivery data for charting

Response Format

All responses are JSON:

{ "success": true, "data": { ... }, "error": null }

Errors return success: false with error details.

Rate Limits

  • Free plan: 100 requests/day
  • Pro plan: 1,000 requests/day
  • Enterprise: Unlimited

Rate limit info in response headers: X-RateLimit-Remaining

SDKs & Libraries

Official SDKs coming soon for:

  • • Python
  • • JavaScript/Node.js
  • • Go
  • • PHP

For now, use curl or your favorite HTTP client with the REST API above.

Webhooks

Get real-time notifications for order events. Set your webhook URL in Settings → Webhooks.

Events:

  • order.created
  • order.started
  • order.delivering
  • order.completed
  • order.failed
POST your_webhook_url { "event": "order.completed", "order_id": "order_123", "views_delivered": 10000, "completed_at": "2025-02-15T10:30:00Z" }

Need Help?

Full API reference and code examples at our developer portal. Email dev@shsmmpanel.com for support.

Contact Developer Support