How does the SparkLikes API work?
The API works like most SMM panel APIs: you send a POST request to a single URL with your key, an action and that action's parameters, and the reply is JSON.
- Endpoint: https://api.sparklikes.com/api/v2
- Method: POST
- Body: form-encoded (application/x-www-form-urlencoded) or JSON
- Authentication: your API key in the key parameter
- Reply: JSON. Errors come back as {"error": "message"}.
Orders placed through the API are charged to your wallet, appear in your order history and follow the same refill and refund rules as orders placed on the site.
How do I get an API key?
You create an API key in the account app after signing up for a free account. Open the API section, create a key and copy it into your panel or script.
Treat the key like a password: anyone who has it can place orders against your wallet. If it leaks, delete it and create a new one in the account app. Top up your wallet before placing orders, by UPI or USDT; see payment methods.
Which actions does the API support?
The API supports six actions:
- services: list all services with rate, minimum, maximum and whether refill is supported.
- add: place a new order.
- status: get the status of one order, or several at once.
- refill: request a refill on a completed, refill-eligible order.
- refill_status: check the status of a refill request.
- balance: get your wallet balance.
How do I list services?
Send action=services with your key to get every service available to your account. Rates are per 1,000 units, in your account currency.
Request: key=YOUR_API_KEY&action=services
Reply: [{"service": 1, "name": "Instagram Followers · High-Retention · 60-day refill", "type": "Default", "category": "Instagram Followers", "rate": "120.00", "min": "50", "max": "50000", "refill": true, "cancel": false}]
The values above are an example of the format only. Always read live rates and limits from the services action.
How do I place an order?
Send action=add with a service ID, a link and a quantity. The reply is the new order ID.
Request: key=YOUR_API_KEY&action=add&service=1&link=https://www.instagram.com/yourusername/&quantity=1000
Reply: {"order": "SLX3CEB3QS9D"}
Some service types take extra parameters, such as comments (one comment per line) for custom comment services. The link must be public. The order is charged to your wallet when it is accepted; if your balance is too low you get an error and no order is created.
How do I check order status?
Send action=status with an order ID. For several orders, send orders with up to 100 comma-separated IDs.
Request: key=YOUR_API_KEY&action=status&order=SLX3CEB3QS9D
Reply: {"charge": "120.00", "start_count": "3572", "status": "In progress", "remains": "157", "currency": "INR"}
Multiple orders: key=YOUR_API_KEY&action=status&orders=SLX3CEB3QS9D,SLWRONG0000
Reply: {"SLX3CEB3QS9D": {"charge": "120.00", "start_count": "3572", "status": "Completed", "remains": "0", "currency": "INR"}, "SLWRONG0000": {"error": "Incorrect order ID"}}
Status values are Pending, In progress, Processing, Completed, Partial and Canceled. For Partial and Canceled orders, the undelivered amount is refunded to your wallet automatically.
How do I request a refill through the API?
Send action=refill with the order ID of a completed order whose service supports refill and whose refill window is still open. The reply is a refill ID.
Request: key=YOUR_API_KEY&action=refill&order=SLX3CEB3QS9D
Reply: {"refill": "1"}
Check progress with refill_status: key=YOUR_API_KEY&action=refill_status&refill=1
Reply: {"status": "Completed"}
Refills usually start within about 24 hours. Requests on services without refill, or outside the window, return an error. The rules are in our refill and drop policy.
Can I cancel an order?
You can't. Orders are sent for delivery the moment they're placed and can't be cancelled afterwards, so check the link and quantity before you order. The cancel action exists only for script compatibility and always returns an error.
If an order can't be delivered, it is marked Canceled or Partial and the undelivered amount is refunded to your wallet automatically.
How do I check my balance?
Send action=balance to get your current wallet balance and its currency.
Request: key=YOUR_API_KEY&action=balance
Reply: {"balance": "2540.50", "currency": "INR"}
What errors can the API return?
Errors return a JSON object with an error message and no other fields. Common ones:
- Invalid API key: the key is missing, wrong or deleted.
- Incorrect request / unknown action: the action name is not one of the seven above.
- Not enough funds: your wallet balance does not cover the order.
- Incorrect service ID, link or quantity: the service does not exist, the link is not valid for it, or the quantity is outside min and max.
- Refill not available: the service has no refill, the order is not completed, or the window has closed.
Please poll status at a sensible interval, for example every few minutes per batch of orders, rather than in a tight loop. Heavy polling may be slowed down.