On this page

SMM Panel API Documentation

API Version: v2

SmmFoxi provides a standard SMM Panel API (v2) so you can integrate 373 social media marketing services directly into your reseller panel, bot or app. Fast start on eligible services, competitive pricing and full automation. This documentation covers all available endpoints and their usage.

Before you start: get API access in 4 steps

You need an account, a funded balance and an API key before your first call. Setup takes a few minutes:

  1. 1

    Create an account

    Sign up for a SmmFoxi account. The same account is used for the web dashboard and the API.

    Sign up →
  2. 2

    Top up your balance

    API orders are charged to your account balance. Add funds in the dashboard; you can check the balance any time with action=balance.

    Open dashboard →
  3. 3

    Get your API key

    Go to Dashboard → API and generate a key. It is shown in full only once — copy and store it safely. Refreshing it disables the old key immediately.

    Get API key →
  4. 4

    Integrate and test

    Send POST requests to the endpoint below with your key and an action. Start with action=services to load service IDs and prices, then place a small test order.

    See endpoint →

API Endpoint

https://smmfoxi.com/api/v2

All requests should be sent to this endpoint via POST or GET method.

Authentication

All API requests require authentication using your API key. Generate it in Dashboard → API (the full key is shown only once, so save it right away). Include the key parameter in every request.

POST https://smmfoxi.com/api/v2
Content-Type: application/json

{
  "key": "YOUR_API_KEY",
  "action": "services"
}

Response Format

All responses are returned in JSON format. Successful requests return the requested data, while errors return an error object with a description.

API Endpoints

Get Services

Returns a list of all available services with their details including pricing, minimum and maximum quantities.

Parameters

  • key - Your API key (required)
  • action - "services"
// Example Response
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",
    "min": "100",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

Get Balance

Returns your current account balance and currency.

Parameters

  • key - Your API key (required)
  • action - "balance"
// Example Response
{
  "balance": "100.84292",
  "currency": "USD"
}

Add Order

Create a new order for a service. The required parameters depend on the service type.

Default Type

  • key - Your API key (required)
  • action - "add"
  • service - Service ID (required)
  • link - Target URL (required)
  • quantity - Order quantity (required)

Package Type

  • key - Your API key (required)
  • action - "add"
  • service - Service ID (required)
  • link - Target URL (required)

Custom Comments Type

  • key - Your API key (required)
  • action - "add"
  • service - Service ID (required)
  • link - Target URL (required)
  • comments - Comments separated by newline (required)
// Example Response
{
  "order": 23501
}

Order Status

Get the status of one or more orders. You can query a single order or multiple orders at once.

Single Order

  • key - Your API key (required)
  • action - "status"
  • order - Order ID (required)

Multiple Orders (up to 100)

  • key - Your API key (required)
  • action - "status"
  • orders - Order IDs separated by comma (required)
// Example Response
{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Completed",
  "remains": "0",
  "currency": "USD"
}

Create Refill

Request a refill for an order. Only available for services that support refills.

Parameters

  • key - Your API key (required)
  • action - "refill"
  • order - Order ID (required)
// Example Response
{
  "refill": "1"
}

Refill Status

Check the status of a refill request.

Parameters

  • key - Your API key (required)
  • action - "refill_status"
  • refill - Refill ID (required)
// Example Response
{
  "status": "Completed"
}

Order Statuses

  • Pending - Order is waiting to be processed
  • Processing - Order is being prepared
  • In progress - Order is currently running
  • Completed - Order has been completed successfully
  • Partial - Order was partially completed (refund issued for remaining)
  • Canceled - Order was canceled

Error Handling

When an error occurs, the API returns a JSON object with an error field describing the issue.

// Error Response Example
{
  "error": "Invalid API key"
}

Rate Limits

To ensure service quality, the following rate limits apply:

  • 5 requests per second
  • 100 requests per minute
  • 1000 requests per hour