API Hujjatlari — SeenSMS

Umumiy ma'lumot

Endpoint	`https://seensms.uz/api/v1`
Metod	`GET` yoki `POST`
Format	JSON
Autentifikatsiya	Har so'rovda `key` (API kalit) yuboriladi
Valyuta	UZS (so'm)

💡 Tezlik uchun: so'rovga Accept-Encoding: gzip sarlavhasini qo'shing — katta javoblar ~15 barobar siqiladi va tezroq keladi.

Tez boshlash

Balansni tekshirish — eng oddiy so'rov. Uch tilda misol:

curl --compressed -X POST https://seensms.uz/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"
<?php
$ch = curl_init('https://seensms.uz/api/v1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_ENCODING, 'gzip');
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'key' => 'YOUR_API_KEY',
    'action' => 'balance',
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);
import requests

URL = 'https://seensms.uz/api/v1'

r = requests.post(URL, data={
    'key': 'YOUR_API_KEY',
    'action': 'balance',
})
print(r.json())

Javob:

{
    "balance": 100000.00,
    "currency": "UZS"
}

🤖 AI bilan integratsiya (eng oson yo'l)

Quyidagi promtni nusxalang va ChatGPT / Claude / Cursor / Geminiga bering — u sizning loyihangiz uchun to'liq, ishlaydigan API mijozini yozib beradi. Promt oxirida o'z talabingizni yozing (masalan: "Laravel uchun yoz" yoki "Python Telegram bot uchun yoz").

You are integrating the SeenSMS API into my project.

BASE URL: https://seensms.uz/api/v1
METHOD: POST (application/x-www-form-urlencoded) or GET. Responses: JSON. Amounts in UZS.
AUTH: every request sends `key` (my API key) and `action`. On error the JSON has an "error" field.
Send header: Accept-Encoding: gzip. Rate limit per key: 1200/min for actions, 120/min for list actions.

ACTIONS (value of the `action` field):

SMM:
  services -> [{service,name,type,category,rate,min,max,refill,cancel}]
  add {service,link,quantity} -> {order}
  status {order} -> {charge,start_count,status,remains,currency}
     status = Pending | Processing | In progress | Partial | Completed | Canceled
  refill {order} -> {refill}
  cancel {order} -> {order,cancel}
  balance -> {balance,currency}

Virtual numbers (receive SMS):
  numbers_services -> [{service,name}]
  numbers_countries {service} -> [{country,name,price,count}]
  numbers_get {country,service} -> {id,number,cost}
  numbers_status {id} -> {id,status,code}   status = WAITING | OK | EXPIRED
  numbers_cancel {id} -> {id,cancel,refunded}

Ready Telegram accounts:
  accounts_countries -> [{country,price}]
  accounts_get {country} -> {id,number,cost}
  accounts_code {id} -> {id,status,code,password}   status = WAITING | OK

Telegram Stars / Premium:
  user_info {username,type} -> {found,name,recipient,avatar}
  stars_prices -> [{quantity,price}]
  stars_buy {username,quantity} -> {id,status,amount}
  premium_prices -> [{months,price}]
  premium_buy {username,months} -> {id,status,amount}
  stars_status {id} -> {id,type,username,amount,status,error}

TASK:
Build a clean, reusable SeenSMS API client — one method per action, error handling on the "error"
field, gzip enabled, and request timeouts. Then: [describe what you want here — e.g. "for PHP/Laravel",
"a Python Telegram bot that resells Stars", "a Node.js service"].
My API key: [paste your API key here]

💰 Chegirmalar

Darajalar (jami aylanmaga qarab):

0%

Boshlang'ich

Sizning darajangiz

3%

20 000 000+ so'm

5%

50 000 000+ so'm

8%

100 000 000+ so'm

Chegirmangizni oshirish yoki maxsus shart uchun qo'llab-quvvatlashga murojaat qiling.

So'rov chegaralari (Rate Limits)

Chegaralar API kalit bo'yicha, daqiqada hisoblanadi. Deyarli cheksiz — limit oshsa 429 Too Many Requests qaytadi.

Action guruhi	Chegara	Izoh
Yengil: `status`, `balance`, `add`, `refill`, `cancel`, `numbers_` (get/status/cancel), `accounts_` (get/code)	1200 / daqiqa	20/sekund — erkin ishlating
Og'ir ro'yxatlar: `services`, `numbers_services`, `numbers_countries`, `accounts_countries`	120 / daqiqa	Kam o'zgaradi — bir marta oling, keshlang

⚠️ Xizmatlar/davlatlar ro'yxatini har so'rovdan oldin emas, daqiqada 1 marta oling va bot xotirasida saqlang. Bu botingizni tez va uzluksiz qiladi.

Xizmatlar ro'yxati POST

Parametr	Qiymat
`key` majburiy	API kalitingiz
`action` majburiy	`services`

curl --compressed -X POST https://seensms.uz/api/v1 \
  -d "key=YOUR_API_KEY" -d "action=services"
<?php
$ch = curl_init('https://seensms.uz/api/v1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_ENCODING, 'gzip');
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'key' => 'YOUR_API_KEY', 'action' => 'services',
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);
import requests

URL = 'https://seensms.uz/api/v1'

r = requests.post(URL, data={'key':'YOUR_API_KEY','action':'services'})
print(r.json())

Javob (rate — 1 dona narxi UZS, refill/cancel — 1 yoki 0):

[
  {
    "service": 7,
    "name": "IG Like",
    "type": "Tez boshlanadi | Kafolat: 30 kun",
    "category": "Instagram Like",
    "rate": 1500,
    "min": 1,
    "max": 10000000,
    "refill": 0,
    "cancel": 1
  }
]

Buyurtma berish POST

Parametr	Qiymat
`key` majburiy	API kalitingiz
`action` majburiy	`add`
`service` majburiy	Xizmat ID (services'dan)
`link` majburiy	Havola (post/profil)
`quantity` majburiy	Miqdor

curl --compressed -X POST https://seensms.uz/api/v1 \
  -d "key=YOUR_API_KEY" -d "action=add" \
  -d "service=1" \
  -d "link=https://instagram.com/p/xxx" \
  -d "quantity=100"
<?php
$ch = curl_init('https://seensms.uz/api/v1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_ENCODING, 'gzip');
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'key' => 'YOUR_API_KEY', 'action' => 'add',
    'service' => 1,
    'link' => 'https://instagram.com/p/xxx',
    'quantity' => 100,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);
import requests

URL = 'https://seensms.uz/api/v1'

r = requests.post(URL, data={
    'key':'YOUR_API_KEY', 'action':'add',
    'service':1, 'link':'https://...', 'quantity':100,
})
print(r.json())

Javob:

{
    "order": 731624
}

Buyurtma holati POST

Parametr	Qiymat
`key` majburiy	API kalitingiz
`action` majburiy	`status`
`order` majburiy	Buyurtma ID (bir nechta — vergul bilan)

curl --compressed -X POST https://seensms.uz/api/v1 \
  -d "key=YOUR_API_KEY" -d "action=status" -d "order=731624"
<?php
$ch = curl_init('https://seensms.uz/api/v1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_ENCODING, 'gzip');
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'key'=>'YOUR_API_KEY', 'action'=>'status', 'order'=>731624,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);
import requests

URL = 'https://seensms.uz/api/v1'

r = requests.post(URL, data={'key':'YOUR_API_KEY','action':'status','order':731624})
print(r.json())

Javob:

{
    "charge": 900,
    "start_count": "1200",
    "status": "In progress",
    "remains": "157",
    "currency": "UZS"
}

Bir nechta buyurtma (order=731624,731625) — massiv qaytadi:

[
    { "charge": 900, "start_count": "1200", "status": "Completed", "remains": "0", "currency": "UZS" },
    { "error": "Order not found" }
]

Mumkin bo'lgan status qiymatlari:

Qiymat	Ma'nosi
`Queued`	Navbatda — vaqtincha kutilmoqda, avtomatik yuboriladi
`Pending`	Qabul qilindi — hali boshlanmagan
`Processing`	Qayta ishlanmoqda
`In progress`	Bajarilmoqda
`Partial`	Qisman bajarildi (qoldig'i qaytarilgan)
`Completed`	To'liq yakunlandi
`Canceled`	Bekor qilindi (pul qaytarilgan)

Refill POST

Parametr	Qiymat
`key` majburiy	API kalitingiz
`action` majburiy	`refill`
`order` majburiy	Buyurtma ID (yoki `orders` — vergul bilan)

curl --compressed -X POST https://seensms.uz/api/v1 \
  -d "key=YOUR_API_KEY" -d "action=refill" -d "order=731624"
<?php
$ch = curl_init('https://seensms.uz/api/v1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_ENCODING, 'gzip');
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'key'=>'YOUR_API_KEY', 'action'=>'refill', 'order'=>731624,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);
import requests

URL = 'https://seensms.uz/api/v1'

r = requests.post(URL, data={'key':'YOUR_API_KEY','action':'refill','order':731624})
print(r.json())

Javob:

{
    "refill": "1"
}

Bekor qilish POST

Parametr	Qiymat
`key` majburiy	API kalitingiz
`action` majburiy	`cancel`
`order` majburiy	Buyurtma ID

curl --compressed -X POST https://seensms.uz/api/v1 \
  -d "key=YOUR_API_KEY" -d "action=cancel" -d "order=731624"
<?php
$ch = curl_init('https://seensms.uz/api/v1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_ENCODING, 'gzip');
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'key'=>'YOUR_API_KEY', 'action'=>'cancel', 'order'=>731624,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);
import requests

URL = 'https://seensms.uz/api/v1'

r = requests.post(URL, data={'key':'YOUR_API_KEY','action':'cancel','order':731624})
print(r.json())

Javob:

{
    "order": 731624, "cancel": 1
}

Balans POST

Parametr	Qiymat
`key` majburiy	API kalitingiz
`action` majburiy	`balance`

curl --compressed -X POST https://seensms.uz/api/v1 \
  -d "key=YOUR_API_KEY" -d "action=balance"
<?php
$ch = curl_init('https://seensms.uz/api/v1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_ENCODING, 'gzip');
curl_setopt($ch, CURLOPT_POSTFIELDS, ['key'=>'YOUR_API_KEY','action'=>'balance']);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);
import requests

URL = 'https://seensms.uz/api/v1'

r = requests.post(URL, data={'key':'YOUR_API_KEY','action':'balance'})
print(r.json())

Javob:

{
    "balance": 100000.00, "currency": "UZS"
}

📱 Virtual raqamlar (SMS qabul qilish)

Vaqtinchalik raqam olib, unga kelgan SMS kodini olasiz. Narx balansdan yechiladi. 5 ta action:

POST 1. Xizmatlar — action=numbers_services

Parametr: faqat key. Qaysi xizmatlar borligini qaytaradi.

[
  { "service": "tg", "name": "Telegram" },
  { "service": "wa", "name": "WhatsApp" }
]

POST 2. Davlatlar + narx — action=numbers_countries

Parametr: service (masalan tg).

[
  { "country": "6", "name": "Indoneziya", "price": 2625, "count": 50389 }
]

POST 3. Raqam olish — action=numbers_get

`country` majburiy	Davlat kodi
`service` majburiy	Xizmat kodi (masalan `tg`)

curl --compressed -X POST https://seensms.uz/api/v1 \
  -d "key=YOUR_API_KEY" -d "action=numbers_get" \
  -d "country=6" -d "service=tg"
<?php
$ch = curl_init('https://seensms.uz/api/v1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_ENCODING, 'gzip');
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'key'=>'YOUR_API_KEY', 'action'=>'numbers_get',
    'country'=>'6', 'service'=>'tg',
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);
import requests

URL = 'https://seensms.uz/api/v1'

r = requests.post(URL, data={
    'key':'YOUR_API_KEY', 'action':'numbers_get',
    'country':'6', 'service':'tg',
})
print(r.json())

Javob:

{
    "id": 123456, "number": "628123456789",
    "country": "6", "service": "tg", "cost": 26.25
}

POST 4. SMS kodini tekshirish — action=numbers_status

Parametr: id (numbers_get'dan). Kod kelguncha takror so'rang.

// Kutilmoqda:
{ "id": 123456, "status": "WAITING" }

// Kod keldi:
{ "id": 123456, "status": "OK", "code": "12345" }

// Muddati tugadi:
{ "id": 123456, "status": "EXPIRED" }

POST 5. Bekor qilish (pul qaytariladi) — action=numbers_cancel

Parametr: id. Raqam olganingizdan kamida 2 daqiqa o'tishi kerak. SMS kelgan raqam bekor qilinmaydi.

{ "id": 123456, "cancel": true, "refunded": 26.25 }

👤 Tayyor hisoblar (Telegram akkauntlar)

Tayyor Telegram raqam olib, kirish kodini (+ 2FA parol) olasiz. 3 ta action:

POST 1. Davlatlar + narx — action=accounts_countries

Parametr: faqat key.

[
  { "country": "US", "price": 5775 },
  { "country": "IN", "price": 6125 }
]

POST 2. Hisob olish — action=accounts_get

country majburiy Davlat kodi (2 harf, masalan US)

curl --compressed -X POST https://seensms.uz/api/v1 \
  -d "key=YOUR_API_KEY" -d "action=accounts_get" -d "country=US"
<?php
$ch = curl_init('https://seensms.uz/api/v1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_ENCODING, 'gzip');
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'key'=>'YOUR_API_KEY', 'action'=>'accounts_get', 'country'=>'US',
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);
import requests

URL = 'https://seensms.uz/api/v1'

r = requests.post(URL, data={
    'key':'YOUR_API_KEY', 'action':'accounts_get', 'country':'US',
})
print(r.json())

Javob:

{
    "id": 7890, "number": "12025550123",
    "country": "US", "cost": 57.75
}

POST 3. Kirish kodini tekshirish — action=accounts_code

Parametr: id (accounts_get'dan).

// Kutilmoqda:
{ "id": 7890, "status": "WAITING" }

// Kod keldi (2FA parol bilan):
{ "id": 7890, "status": "OK", "code": "33450", "password": "h1i4b92" }

⭐️ Telegram Stars

Istalgan Telegram foydalanuvchisiga Stars yuboring. Narx balansdan yechiladi. API orqali telefon/SMS tasdiqlash talab qilinmaydi.

POST 0. Username tekshirish — action=user_info

Buyurtmadan oldin qabul qiluvchi to'g'ri ekanini tekshiring (Stars va Premium uchun).

`username` majburiy	Telegram username (masalan `durov`)
`type` ixtiyoriy	`stars` (standart), `premium`

// Topildi:
{
    "found": true,
    "username": "durov",
    "name": "Pavel Durov",
    "recipient": "Pavel",
    "avatar": "https://..."
}

// Topilmadi:
{ "found": false, "error": "User not found" }

POST 1. Narxlar — action=stars_prices

Parametr: faqat key. Mavjud miqdorlar va UZS narxi.

[
  { "quantity": 50, "price": 12987 },
  { "quantity": 100, "price": 25974 },
  { "quantity": 1000, "price": 259740 }
]

POST 2. Buyurtma — action=stars_buy

`username` majburiy	Qabul qiluvchi (masalan `durov`)
`quantity` majburiy	50, 75, 100, 150, 250, 500, 1000, 2500, 5000, 10000, 25000, 50000

curl --compressed -X POST https://seensms.uz/api/v1 \
  -d "key=YOUR_API_KEY" -d "action=stars_buy" \
  -d "username=durov" -d "quantity=100"
<?php
$ch = curl_init('https://seensms.uz/api/v1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_ENCODING, 'gzip');
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'key' => 'YOUR_API_KEY', 'action' => 'stars_buy',
    'username' => 'durov', 'quantity' => 100,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);
import requests

URL = 'https://seensms.uz/api/v1'

r = requests.post(URL, data={
    'key': 'YOUR_API_KEY', 'action': 'stars_buy',
    'username': 'durov', 'quantity': 100,
})
print(r.json())

Javob:

{
    "id": 4521,
    "status": "queued",
    "amount": 25974
}

💎 Telegram Premium

Istalgan foydalanuvchiga Premium obuna sovg'a qiling.

POST 1. Narxlar — action=premium_prices

[
  { "months": 3, "price": 177422 },
  { "months": 6, "price": 236763 },
  { "months": 12, "price": 429170 }
]

POST 2. Buyurtma — action=premium_buy

`username` majburiy	Qabul qiluvchi
`months` majburiy	3, 6 yoki 12

curl --compressed -X POST https://seensms.uz/api/v1 \
  -d "key=YOUR_API_KEY" -d "action=premium_buy" \
  -d "username=durov" -d "months=3"
<?php
$ch = curl_init('https://seensms.uz/api/v1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_ENCODING, 'gzip');
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'key' => 'YOUR_API_KEY', 'action' => 'premium_buy',
    'username' => 'durov', 'months' => 3,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);
import requests

URL = 'https://seensms.uz/api/v1'

r = requests.post(URL, data={
    'key': 'YOUR_API_KEY', 'action': 'premium_buy',
    'username': 'durov', 'months': 3,
})
print(r.json())

Javob:

{
    "id": 4522,
    "status": "queued",
    "amount": 177422
}

POST 3. Buyurtma holati — action=stars_status

Stars va Premium buyurtmalari uchun. Parametr: id (buyurtmadan qaytgan).

{
    "id": 4521,
    "type": "stars",
    "username": "durov",
    "quantity": 100,
    "amount": 25974,
    "status": "success",
    "error": null
}

Mumkin bo'lgan status: queued · processing · success · partial · failed (pul qaytariladi) · cancelled

Xatolar

Xato bo'lsa javobda error maydoni bo'ladi. Namunalar:

Xabar	Sabab
`Invalid API key`	Kalit noto'g'ri yoki topilmadi
`Invalid action`	Noma'lum action
`Balansda yetarli mablag' yo'q`	Balans yetmaydi
`Buyurtma topilmadi`	ID noto'g'ri yoki sizniki emas
`429 Too Many Requests`	So'rov chegarasi oshdi — biroz kuting

Yordam kerakmi? Qo'llab-quvvatlash xizmatiga murojaat qiling.