For resellers

UpSocialz API

Connect your SMM panel and resell our services. It is the standard panel API (v2), so most panel software needs only the URL and your key. Orders are paid from your UpSocialz wallet in cedis.

Get your API key

API URL: https://www.upsocialz.com/api/v2
Method: POST, form-encoded or JSON
Currency: GHS (Ghana cedis)
Limit: 60 requests a minute per key

Your API key

Create it in your account under Profile, API access. We show it once, in full: copy it into your panel then.
You have one key at a time. Creating a new one replaces the old one at once, and the old key gets “Invalid API key” from then on.
Keep it secret: anyone with it can order from your wallet. If it leaks, replace it.

Requests

Send every request as a POST to the API URL, with key and action in the body, form-encoded or as JSON.

Never put the key in the URL. A request with anything after a question mark in the URL is refused with “Incorrect request”, and so is a GET, so your key never ends up in a link or a server log.

Every answer is JSON. A refusal comes with HTTP status 200, as panel software expects, and looks like {"error": "Invalid API key"}. An HTTP 500 means a fault on our side: try again later, and after a 500 on add, check your order list or balance before you send it again. Amounts are in cedis, as text with two decimals.

A request as JSON

curl https://www.upsocialz.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key": "YOUR_API_KEY", "action": "balance"}'

Actions

action and fields	Answers
services	Every service you can order, with your rate
add+ service, link, quantity	The order number
status+ order	Its charge, status and how many are left
status+ orders	Each order by its number, or an error for that number
balance	Your wallet balance
refill, cancel	Always the error “Not supported”

List services

action=services

rate is the price per 1,000 in cedis, after your discount. min and max are the smallest and largest quantity.

Only services that need just a link and a quantity are listed. Services that take more, such as custom comments, are ordered on the website.

type is always Default, and refill and cancel are always false.

Request

curl https://www.upsocialz.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=services

Answer

[
  {
    "service": 278,
    "name": "TikTok Likes",
    "type": "Default",
    "category": "TikTok Likes",
    "rate": "232.50",
    "min": "50",
    "max": "3000",
    "refill": false,
    "cancel": false
  }
]

Place an order

action=add

service: The service number from services.
link: The profile or post, on that service's platform.
quantity: How many, between the service's min and max.

The order is paid from your wallet straight away, like an order on the website, and starts at once.

Some services sell in steps, for example only multiples of 100. The services list cannot show steps, so a quantity off the step gets “Quantity out of range”. The service's page on our website shows its step.

Request

curl https://www.upsocialz.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=278 \
  --data-urlencode link=https://www.tiktok.com/@ama/video/7301234567890123456 \
  -d quantity=50

Answer

{
  "order": 52301
}

Check an order

action=status

order: An order number from add.

charge is what the order costs you now: a refund comes off it. remains is how many are still to deliver, 0 once it is completed. start_count is the count when delivery started, 0 until we know it.

Request

curl https://www.upsocialz.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d order=52301

Answer

{
  "charge": "11.63",
  "start_count": "1520",
  "status": "In progress",
  "remains": "35",
  "currency": "GHS"
}

Check several orders

action=status

orders: Up to 100 order numbers, separated by commas.

A number that is not one of your orders gets its own error; the others still answer.

Request

curl https://www.upsocialz.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d orders=52301,52302

Answer

{
  "52301": {
    "charge": "11.63",
    "start_count": "1520",
    "status": "Completed",
    "remains": "0",
    "currency": "GHS"
  },
  "52302": {
    "error": "Incorrect order ID"
  }
}

Check your balance

action=balance

Add funds on the Wallet page of your account. The API cannot add funds.

Request

curl https://www.upsocialz.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

Answer

{
  "balance": "100.84",
  "currency": "GHS"
}

Refill and cancel

action=refillaction=cancel

Orders cannot be refilled or cancelled once placed. A failed order, or the undelivered part of a partial one, is refunded to your wallet automatically.

Request

curl https://www.upsocialz.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=refill \
  -d order=52301

Answer

{
  "error": "Not supported"
}

Order statuses

status	Means
Pending	Received and about to start.
In progress	Delivering.
Completed	Delivered in full.
Partial	Stopped before the end. The part not delivered is refunded to your wallet.
Canceled	Not delivered. The full charge is refunded to your wallet.
Processing	We are checking it by hand. It moves on to another status after that.

Errors

Errors come as {"error": "..."} with one of these texts, exactly as written.

error	When
Invalid API key	The key is missing or mistyped, has been replaced or revoked, or the account is suspended.
Not enough funds on balance	Your wallet cannot pay for the order. Add funds, then send it again.
Incorrect service ID	There is no service with that number in the API: it is unknown, no longer offered, or needs more than a link and a quantity.
Incorrect link	The link is missing, or it is not a link on that service's platform.
Quantity out of range	The quantity is not a whole number, is below `min` or above `max`, or is not a multiple of the service's step.
Ordering is paused	We have paused new orders for a short while. Try again later.
Account suspended	The account was suspended while the order was being placed. Contact support.
Too many requests	Over 60 requests a minute with one key, over 20 orders a minute on one account, or over 120 requests a minute with bad keys from one address. Wait a minute.
Not supported	`refill` and `cancel`: orders cannot be refilled or cancelled.
Incorrect request	The request could not be read: the URL has a query string, it is a GET, the action is missing or unknown, a `status` call names no `order`, or its `orders` list is not numbers or is longer than 100.
Incorrect order ID	The order number is not a number, or it is not one of your orders.

Limits

60 requests a minute per key.
20 orders a minute per account, from the API and the website together.
120 requests a minute from one address with a missing or wrong key. A valid key is never limited by its address.
Over a limit, requests get “Too many requests”. Wait a minute and try again.