Api Key

API Documentation

This guide provides the necessary information to integrate your application with our panel using the WooCommerce REST API.

1. Authentication

All transactional requests (Order, Status, Balance) must include your unique **API Key** in the request body for authentication. If the key is missing or invalid, the request will be rejected.

NOTE: The cURL examples below use the dynamic placeholder "Your_API_Key", which your website must replace with the logged-in user's actual key before display (e.g., by fetching the content of the element with id="smm_api_key").

---

2. Get Service List (Fetch Available Services)

Use this endpoint to retrieve all available services, their prices, and min/max quantities from our database. This endpoint is **public** and requires no authentication.

Standard SMM Panel Parameters (For Reference Only)

This is the format used by many standard SMM APIs (using your provider's key):

Parameter	Description
key	Your_API_Key
action	services

Our Custom Endpoint & Method

GET https://socialgrowth.me/wp-json/smm-orders/v1/services

Parameters

This endpoint requires **no parameters** in the request body or URL. It is public.

Example Request (cURL)

Use the following cURL command to retrieve the list:

curl -X GET "https://socialgrowth.me/wp-json/smm-orders/v1/services"
    

Example Response (JSON)

Services are grouped by Category in the response:

{
    "Category 1": [
        {
            "service_id": "100",
            "name": "Placeholder - High Quality Test Service",
            "category": "Category 1",
            "price": "3.500000",
            "min": "100",
            "max": "5000",
            "description": "...",
            "type": "Default"
        }
    ],
    "Category 22": [
        {
            "service_id": "9",
            "name": "Service 2",
            "category": "Category 22",
            "min": "50",
            "max": "100",
            "description": "Description 2",
            "price": "12.000000",
            "type": "default"
        }
    ]
}
    

---

3. Place New Order (Instant Payment)

This endpoint places an order instantly using your **Wallet Balance** as payment. If payment is successful, the order is sent to the provider immediately.

Endpoint & Method

POST https://socialgrowth.me/wp-json/smm-users/v1/add

Request Parameters (JSON Format)

Parameter	Required	Type	Description
api_key	YES	String	Your unique key for authentication.
service_id	YES	Integer	The internal service ID you want to order (from the /services list).
link	YES	String	The URL/link where the service should be delivered.
quantity	YES	Integer	The desired amount.
comments	NO	String	Optional. Any additional notes for the order.

Example Request (cURL)

curl -X POST "https://socialgrowth.me/wp-json/smm-users/v1/add" \
     -H "Content-Type: application/json" \
     -d '{
        "api_key": "Your_API_Key",
        "service_id": 100,
        "link": "https://instagram.com/p/ExamplePost",
        "quantity": 500
     }'
    

Success Response

{
    "status": "success",
    "message": "Order placed, paid, and submitted instantly to SMM provider.",
    "order_id": 12345,
    "total_cost": 1.75
}
    

---

4. Get Order Status

Check the current status and cost of a previously placed order using the **WooCommerce Order ID** returned by the /add endpoint.

Endpoint & Method

POST https://socialgrowth.me/wp-json/smm-users/v1/status

Request Parameters (JSON Format)

Parameter	Required	Type	Description
api_key	YES	String	Your unique key for authentication.
order	YES	Integer	The WooCommerce Order ID (e.g., 12345) to check.

Example Request (cURL)

curl -X POST "https://socialgrowth.me/wp-json/smm-users/v1/status" \
     -H "Content-Type: application/json" \
     -d '{
        "api_key": "Your_API_Key",
        "order": 12345
     }'
    

Example Response (JSON)

{
"status": "success",
"wc_order_id": 12345,
"smm_order_id": 98765,
"api_status": "Processing",
"wc_status": "processing",
"charge": 1.75
}