services, add, status, refill, refill_status, cancel, balance — POST https://webkit.guru/api/v2

Developers

API for resellers and automation

One HTTP endpoint de cover the whole workflow: read the catalogue, place orders, poll their status, request refills and cancellations. The protocol de match the format wey most SMM panels de use, so an existing integration usually no need anything but a new URL and key.

Address

POST https://webkit.guru/api/v2

POST only. Send either application/x-www-form-urlencoded or application/json — dem de accept both, and responses de always JSON.

Authentication

The key de travel for the request body as the key field. We de store only im SHA-256 hash, so a key no fit recover from our database — if you lose am, issue a new one. A key fit revoke from the dashboard at any moment and e de stop work immediately.

Rate limit

60 requests per minute from one IP address. Above that the endpoint de answer 429 and de include a Retry-After header wey go tell you how many seconds to wait. Poll statuses for batches via orders rather than one call per order.

Methods

action=services

Service list

The full catalogue with prices, limits and refill flags. Prices already include your markup — these are the amounts charged to your balance.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “services”

Response

[
  {
    "service": 21251,
    "name": "Telegram Views",
    "type": "Default",
    "category": "Telegram",
    "rate": 0.41,
    "min": 10,
    "max": 50000000,
    "refill": true,
    "cancel": true
  }
]

action=add

Create order

Charges your balance and queues the order. If the provider rejects it, the amount is refunded automatically.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “add”
service	int	yes	Service ID from the services method
link	string	yes	Link to the profile or post. The format is validated per platform and metric
quantity	int	yes	Quantity within the service min and max
runs	int	no	Drip-feed: how many runs
interval	int	no	Drip-feed: interval between runs, in minutes

Response

{ "order": 84213 }

action=status

Order status

A single order via order, or up to a hundred at once via orders.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “status”
order	int	no	Order ID
orders	int[]	no	Comma-separated IDs, up to 100

Response

{
  "charge": "410.00",
  "start_count": "15420",
  "status": "in_progress",
  "remains": "3180",
  "currency": "RUB"
}

Batch response

{
  "84213": { "charge": "410.00", "status": "completed",   "remains": "0",    "start_count": "15420", "currency": "RUB" },
  "84214": { "charge": "120.00", "status": "in_progress", "remains": "890",  "start_count": "2310",  "currency": "RUB" },
  "84215": { "error": "Incorrect order ID" }
}

action=refill

Request Refill

Available for services flagged refill. Returns a refill ID to check the status with.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “refill”
order	int	no	Order ID
orders	int[]	no	Comma-separated IDs, up to 100

Response

{ "refill": 1932 }

Batch response

[
  { "order": 84213, "refill": 1932 },
  { "order": 84214, "error": "Order is not sent to provider yet" }
]

action=refill_status

Refill status

The ID is ours, not the provider's — you never need to know which supplier fulfils the order.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “refill_status”
refill	int	no	Refill ID
refills	int[]	no	Comma-separated IDs, up to 100

Response

{ "status": "Completed" }

Batch response

[
  { "refill": 1932, "status": "Completed" },
  { "refill": 1933, "status": "Pending" }
]

action=cancel

Cancel order

The provider may refuse a cancellation, so the order moves to cancel_requested. The actual cancellation and refund are confirmed by status sync.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “cancel”
order	int	no	Order ID
orders	int[]	no	Comma-separated IDs, up to 100

Response

{ "cancel": 1 }

Batch response

[
  { "order": 84213, "cancel": 1 },
  { "order": 84214, "error": "Incorrect order ID" }
]

action=balance

Balance

Current account balance, in rubles.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “balance”

Response

{ "balance": "12480.50", "currency": "RUB" }

Code samples

cURL

curl -X POST https://webkit.guru/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=21251 \
  -d link=https://t.me/example/42 \
  -d quantity=1000

PHP

<?php
$response = file_get_contents('https://webkit.guru/api/v2', false, stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => 'Content-Type: application/x-www-form-urlencoded',
        'content' => http_build_query([
            'key'      => 'YOUR_KEY',
            'action'   => 'add',
            'service'  => 21251,
            'link'     => 'https://t.me/example/42',
            'quantity' => 1000,
        ]),
    ],
]));

$order = json_decode($response, true);

Python

import requests

response = requests.post("https://webkit.guru/api/v2", data={
    "key": "YOUR_KEY",
    "action": "add",
    "service": 21251,
    "link": "https://t.me/example/42",
    "quantity": 1000,
})

order = response.json()

JavaScript

const response = await fetch("https://webkit.guru/api/v2", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    key: "YOUR_KEY",
    action: "add",
    service: 21251,
    link: "https://t.me/example/42",
    quantity: 1000,
  }),
});

const order = await response.json();

Order statuses

The status field of the status method de return one of these values.

pending: Accepted by the panel, not yet sent to the provider
in_progress: In progress
processing: Provider accepted it, delivery is about to start
completed: Fully delivered
partial: Partially delivered, the difference is refunded
cancel_requested: Cancellation requested, waiting for the provider
canceled: Cancelled, funds returned
failed: Could not be fulfilled, funds returned

Errors

Business errors de come back with HTTP 200 and an error field. Only authentication and rate limiting de use HTTP status codes.

401 · Invalid API key: The key is unknown or has been disabled in the dashboard
429 · Rate limit exceeded: More than 60 requests per minute from one address. The response carries a Retry-After header
Incorrect order ID: No order with this ID belongs to your account
Unknown action: The action value is not one of those listed above

Ready to connect?

Create account, top up your balance and issue a key on the API tab. No separate approval step dey.

Create account

Developers

API for resellers and automation

Address

POST https://webkit.guru/api/v2

POST only. Send either application/x-www-form-urlencoded or application/json — dem de accept both, and responses de always JSON.

Authentication

Rate limit

Methods

action=services

Service list

The full catalogue with prices, limits and refill flags. Prices already include your markup — these are the amounts charged to your balance.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “services”

Response

[
  {
    "service": 21251,
    "name": "Telegram Views",
    "type": "Default",
    "category": "Telegram",
    "rate": 0.41,
    "min": 10,
    "max": 50000000,
    "refill": true,
    "cancel": true
  }
]

action=add

Create order

Charges your balance and queues the order. If the provider rejects it, the amount is refunded automatically.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “add”
service	int	yes	Service ID from the services method
link	string	yes	Link to the profile or post. The format is validated per platform and metric
quantity	int	yes	Quantity within the service min and max
runs	int	no	Drip-feed: how many runs
interval	int	no	Drip-feed: interval between runs, in minutes

Response

{ "order": 84213 }

action=status

Order status

A single order via order, or up to a hundred at once via orders.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “status”
order	int	no	Order ID
orders	int[]	no	Comma-separated IDs, up to 100

Response

{
  "charge": "410.00",
  "start_count": "15420",
  "status": "in_progress",
  "remains": "3180",
  "currency": "RUB"
}

Batch response

{
  "84213": { "charge": "410.00", "status": "completed",   "remains": "0",    "start_count": "15420", "currency": "RUB" },
  "84214": { "charge": "120.00", "status": "in_progress", "remains": "890",  "start_count": "2310",  "currency": "RUB" },
  "84215": { "error": "Incorrect order ID" }
}

action=refill

Request Refill

Available for services flagged refill. Returns a refill ID to check the status with.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “refill”
order	int	no	Order ID
orders	int[]	no	Comma-separated IDs, up to 100

Response

{ "refill": 1932 }

Batch response

[
  { "order": 84213, "refill": 1932 },
  { "order": 84214, "error": "Order is not sent to provider yet" }
]

action=refill_status

Refill status

The ID is ours, not the provider's — you never need to know which supplier fulfils the order.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “refill_status”
refill	int	no	Refill ID
refills	int[]	no	Comma-separated IDs, up to 100

Response

{ "status": "Completed" }

Batch response

[
  { "refill": 1932, "status": "Completed" },
  { "refill": 1933, "status": "Pending" }
]

action=cancel

Cancel order

The provider may refuse a cancellation, so the order moves to cancel_requested. The actual cancellation and refund are confirmed by status sync.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “cancel”
order	int	no	Order ID
orders	int[]	no	Comma-separated IDs, up to 100

Response

{ "cancel": 1 }

Batch response

[
  { "order": 84213, "cancel": 1 },
  { "order": 84214, "error": "Incorrect order ID" }
]

action=balance

Balance

Current account balance, in rubles.

Parameter	Type	Required	Description
key	string	yes	API key from your dashboard, “API” tab
action	string	yes	The string “balance”

Response

{ "balance": "12480.50", "currency": "RUB" }

Code samples

cURL

curl -X POST https://webkit.guru/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=21251 \
  -d link=https://t.me/example/42 \
  -d quantity=1000

PHP

<?php
$response = file_get_contents('https://webkit.guru/api/v2', false, stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => 'Content-Type: application/x-www-form-urlencoded',
        'content' => http_build_query([
            'key'      => 'YOUR_KEY',
            'action'   => 'add',
            'service'  => 21251,
            'link'     => 'https://t.me/example/42',
            'quantity' => 1000,
        ]),
    ],
]));

$order = json_decode($response, true);

Python

import requests

response = requests.post("https://webkit.guru/api/v2", data={
    "key": "YOUR_KEY",
    "action": "add",
    "service": 21251,
    "link": "https://t.me/example/42",
    "quantity": 1000,
})

order = response.json()

JavaScript

const response = await fetch("https://webkit.guru/api/v2", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    key: "YOUR_KEY",
    action: "add",
    service: 21251,
    link: "https://t.me/example/42",
    quantity: 1000,
  }),
});

const order = await response.json();

Order statuses

The status field of the status method de return one of these values.

pending: Accepted by the panel, not yet sent to the provider
in_progress: In progress
processing: Provider accepted it, delivery is about to start
completed: Fully delivered
partial: Partially delivered, the difference is refunded
cancel_requested: Cancellation requested, waiting for the provider
canceled: Cancelled, funds returned
failed: Could not be fulfilled, funds returned

Errors

Business errors de come back with HTTP 200 and an error field. Only authentication and rate limiting de use HTTP status codes.

401 · Invalid API key: The key is unknown or has been disabled in the dashboard
429 · Rate limit exceeded: More than 60 requests per minute from one address. The response carries a Retry-After header
Incorrect order ID: No order with this ID belongs to your account
Unknown action: The action value is not one of those listed above

Ready to connect?

Create account, top up your balance and issue a key on the API tab. No separate approval step dey.

Create account