K KALINMEDIA

How to connect to an SMM panel API, step by step

By Taz, Kalinmedia · 25 October 2026 · updated 18 November 2026 · 7 min read

To connect to an SMM panel API, you create an API key in your panel account, then send requests to the panel's API URL with your key, an action (such as services, add or status) and the details that action needs. The panel replies in JSON. Most SMM panel scripts already speak this "API v2" format, so connecting is often as simple as pasting the URL and the key.

Key takeaways

  • The SMM panel API v2 is a shared format: one URL, a key, and an action parameter that says what you want.
  • If you run a "Perfect Panel" style panel script, you usually only need the API URL and your key. No coding required.
  • If you write your own code, the main actions are services, add, status, refill, refill_status, cancel and balance.
  • For drip feed, quantity is the amount per batch, runs is the number of batches and interval is the gap in minutes.
  • Keep your key secret, check many orders in one status call, and stay under the rate limit.

What is the SMM panel API v2?

The SMM panel API v2 is an informal standard that many panels follow. Every request goes to one address with your key, an action and any extra parameters. The reply is a small JSON object or list. Because the format is shared, reseller panel scripts can talk to any panel that follows it, and Kalinmedia does. The details:

Item Value
API URL https://kalinmedia.com/api/v2
Method POST (GET also works)
Response format JSON
Your key Create it in Account after you sign up
Rate limit 120 requests a minute per key

Before you start

  1. Sign up and confirm your email. You need a normal customer account first.
  2. Fund your wallet. Orders placed through the API are paid from the same naira wallet as orders on the website. You can top up by bank transfer or card through Korapay.
  3. Create your API key. Go to Account and create the key. Copy it somewhere safe when it appears.
  4. Read the docs page. The API documentation shows every action with a sample reply.

Treat the key like a password for your wallet. Anyone who has it can place orders with your balance. Keep it on your server, never inside website code that runs in a visitor's browser, and never in a public code repository. If you think it has leaked, make a new key in Account. The old one stops working at once.

Option 1: connect a panel script (no code)

If you run your own SMM panel website on a "Perfect Panel" style script, look in your admin area for the section that lets you connect another panel by API. Then:

  1. Paste the API URL: https://kalinmedia.com/api/v2
  2. Paste your API key.
  3. Import or sync the service list.
  4. Set your own selling price for each service you want to show your customers.
  5. Place one small test order from your panel and watch it complete.

Your panel will then place orders, check statuses and request refills by itself.

Option 2: write your own requests

If you are building your own app or script, you send the requests yourself. The examples below use curl. Replace YOUR_KEY with your real key and SERVICE_ID with a service number from the services list.

Check your balance

curl -X POST https://kalinmedia.com/api/v2 \
  -d key=YOUR_KEY \
  -d action=balance

Example reply:

{"balance":"15200.5","currency":"NGN"}

Get the service list

curl -X POST https://kalinmedia.com/api/v2 \
  -d key=YOUR_KEY \
  -d action=services

The reply is a list of services. Each one includes its service number, name, category, price per 1,000 and the smallest and largest quantity you can order. Save the service numbers you plan to use.

Place an order

curl -X POST https://kalinmedia.com/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=SERVICE_ID \
  -d link=https://www.instagram.com/yourpage \
  -d quantity=1000

Example reply:

{"order":"23501"}

Store that order number. You need it for status checks and refills. The link must be public, because no password is ever needed.

Check one order

curl -X POST https://kalinmedia.com/api/v2 \
  -d key=YOUR_KEY \
  -d action=status \
  -d order=23501

Example reply:

{"order":"23501","charge":"900","start_count":"120","status":"In progress","remains":"400","currency":"NGN"}

Here charge is what the order cost from your balance, start_count is the count on the post or profile when the order started, and remains is how many are still to be delivered.

Check many orders in one call

Send orders (with an s) and a comma-separated list of up to 100 order numbers:

curl -X POST https://kalinmedia.com/api/v2 \
  -d key=YOUR_KEY \
  -d action=status \
  -d orders=23501,23502,23503

The reply groups the results by order number, each with the same fields as a single check. This is the best way to track a busy panel.

Drip feed and custom comments through the API

For drip feed (gradual delivery), add runs and interval to the add action:

curl -X POST https://kalinmedia.com/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=SERVICE_ID \
  -d link=https://www.instagram.com/yourpage \
  -d quantity=200 \
  -d runs=5 \
  -d interval=60

On Kalinmedia, quantity here means the amount per batch, so this order sends 200 five times, one hour apart, for 1,000 in total. Interval is in minutes. Not every service can be delivered gradually, so test first. Our guide to drip feed explains when it helps.

For custom comments, send a comments parameter with one comment per line. In a URL-encoded request, each line break is written as %0A, for example comments=Lovely%20work%0AWhere%20can%20I%20buy%20this. Use a custom comments service for this.

Refills and cancels

To ask for a refill on a finished order that has dropped inside its refill window:

curl -X POST https://kalinmedia.com/api/v2 \
  -d key=YOUR_KEY \
  -d action=refill \
  -d order=23501

The reply gives you a refill number. Pass it as refill with action=refill_status to see how the refill is going. To ask for a cancel, send action=cancel with orders set to one or more order numbers. If an order ends as Partial or Canceled, the unused money goes back to your balance automatically. Read what a refill is in SMM for how refill windows work.

What do the order statuses mean?

Status Meaning
Pending Received and waiting to start
In progress Being delivered
Processing Being worked on, treat it like In progress
Completed Fully delivered
Partial Partly delivered, the unused money is refunded to your balance
Canceled Not delivered, the money is refunded to your balance

Common errors and how to fix them

When something is wrong, the reply contains an error message instead of an order number. The usual causes:

  • "Incorrect request": the key or the action is missing. Check your parameter names.
  • "Invalid API key": the key is wrong, has extra spaces, or was replaced by a new one.
  • "Too many requests, please slow down": you went over 120 requests a minute. Batch your status checks.
  • Order not found or incorrect order ID: the order number is wrong or belongs to another account.
  • Order refused: check the quantity against the service's minimum and maximum, check that the link is public, and check your balance.

One last point for your customers: platforms have rules about paid or inauthentic engagement, numbers can drop, and bought engagement works best as social proof alongside real content, never instead of it.

Questions people ask

What is the Kalinmedia API URL?

The URL is https://kalinmedia.com/api/v2. It accepts POST requests (GET also works) and replies in JSON. You create your key in Account after you sign up.

Does the Kalinmedia API work with Perfect Panel?

Yes. It follows the standard SMM panel API v2, so "Perfect Panel" style panel scripts can connect to it out of the box. You paste the API URL and your key in your panel's admin area and sync the services.

What is the rate limit on the API?

At the time of writing, the limit is 120 requests a minute per key. To stay under it, check up to 100 orders in a single status call instead of one call per order.

How do I place a drip feed order through the API?

Use action=add and include runs (the number of batches) and interval (the minutes between batches). The quantity is the amount per batch, so the total delivered is quantity multiplied by runs.

What should I do if my API key leaks?

Make a new key in Account straight away. The old key stops working at once, so update your panel or script with the new key afterwards.

Ready to connect? Read the full API documentation, create your key in Account, and place one small test order first. If you plan to send large volumes, message Taz on WhatsApp to talk about special prices.

Share this guide WhatsApp X Facebook Telegram

Ready to grow?

Pay in naira, track every order live, and only pay for what is delivered.

Need help?