接口文档
请求方式:向以下地址发送 HTTP GET 或 POST 请求: https://smmstones.com/api/v2,参数以表单形式提交。每次请求必须包含 key(您的密钥)和 action。响应格式为 JSON。
余额
| 参数 | 说明 |
key | 您的 API 密钥 |
action | balance |
响应
{
"balance": "100.8400",
"currency": "USD"
}
服务列表
| 参数 | 说明 |
key | 您的 API 密钥 |
action | services |
响应
[
{
"service": 1,
"name": "Instagram Followers",
"type": "Default",
"category": "Instagram",
"rate": "0.9000",
"min": "50",
"max": "10000",
"refill": true,
"cancel": false,
"dripfeed": true
}
]
创建订单
分批投放:传入 runs(≥2)和 interval,订单将分批执行。此时 quantity 表示每批数量,总数量 = quantity × runs;每批数量必须在服务的 min-max 范围内。
参数取决于服务类型,可通过服务列表中的 type 字段获取。
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
quantity |
Нужное количество |
是 |
runs |
Число прогонов (необязательно) |
否 |
interval |
Интервал в минутах (необязательно) |
否 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
comments |
По одному комментарию в строке. Количество заказа равно числу строк. Разделитель - перевод строки (\r\n или \n). |
是 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
quantity |
Нужное количество |
是 |
keywords |
По одному ключевому слову в строке. Разделитель - перевод строки (\r\n или \n). |
是 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
quantity |
Нужное количество |
是 |
hashtag |
Хэштег, из которого провайдер соберёт аудиторию. |
是 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
quantity |
Нужное количество |
是 |
country |
Код или название страны: US или United States. |
是 |
device |
Устройство. Возможные значения: 1 - Десктоп, 2 - Мобильные (Android), 3 - Мобильные (iOS), 4 - Смешанно (мобильные), 5 - Смешанно (мобильные и десктоп). |
是 |
type_of_traffic |
Тип трафика. Возможные значения: 1 - Ключевое слово Google, 2 - Свой реферер, 3 - Без реферера. |
是 |
google_keyword |
Ключевое слово. Обязателен при type_of_traffic = 1. |
否 |
referring_url |
Реферер. Обязателен при type_of_traffic = 2. |
否 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
comments |
По одному комментарию в строке. Количество равно числу строк. Разделитель - перевод строки (\r\n или \n). |
是 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
quantity |
Нужное количество |
是 |
usernames |
По одному аккаунту в строке. Разделитель - перевод строки (\r\n или \n). |
是 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
usernames |
По одному аккаунту в строке. Количество равно числу строк. Разделитель - перевод строки (\r\n или \n). |
是 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
quantity |
Нужное количество |
是 |
username |
Аккаунт, из подписчиков которого провайдер соберёт аудиторию. |
是 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
quantity |
Нужное количество |
是 |
usernames |
По одному аккаунту в строке. Разделитель - перевод строки (\r\n или \n). |
是 |
hashtags |
По одному хэштегу в строке. Разделитель - перевод строки (\r\n или \n). |
是 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
quantity |
Нужное количество |
是 |
media |
Медиа, из лайкнувших которое провайдер соберёт аудиторию. |
是 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
quantity |
Нужное количество |
是 |
username |
Аккаунт автора комментария, которому ставят лайки. |
是 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
username |
Аккаунт, от чьего имени оставляют ответы. |
是 |
comments |
По одному ответу в строке. Количество равно числу строк. Разделитель - перевод строки (\r\n или \n). |
是 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
quantity |
Нужное количество |
是 |
answer_number |
Порядковый номер варианта ответа в опросе. |
是 |
| 参数 | 说明 | 必填 |
key |
Ваш API-ключ |
是 |
action |
add |
是 |
service |
ID услуги |
是 |
link |
Ссылка на страницу |
是 |
quantity |
Нужное количество |
是 |
groups |
По одной группе в строке. Разделитель - перевод строки (\r\n или \n). |
是 |
错误
{
"error": "Not enough funds on balance"
}
订单状态
可传入 order(单个订单),或通过 orders 传入以逗号分隔的多个订单。批量请求会返回“编号 → 结果”形式的对象。
| 参数 | 说明 |
key | 您的 API 密钥 |
action | status |
order | 单个订单 ID |
orders | 多个订单 ID,以逗号分隔,例如 1,2,3 |
响应(单个订单)
{
"charge": "0.27",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
}
响应(多个订单)
{
"1": {
"charge": "0.27",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"2": { "error": "Incorrect order ID" }
}
可能的订单状态
Pending
In progress
Completed
Partial
Canceled
取消订单
| 参数 | 说明 |
key | 您的 API 密钥 |
action | cancel |
order | 单个订单 ID |
orders | 多个订单 ID,以逗号分隔,例如 1,2,3 |
响应(多个订单)
[
{ "order": 1, "cancel": 1 },
{ "order": 2, "cancel": { "error": "Order is already completed" } }
]
补量
| 参数 | 说明 |
key | 您的 API 密钥 |
action | refill |
order | 单个订单 ID |
orders | 多个订单 ID,以逗号分隔,例如 1,2,3 |
响应(多个订单)
[
{ "order": 1, "refill": 2 },
{ "order": 2, "refill": { "error": "Incorrect order ID" } }
]
补量状态
| 参数 | 说明 |
key | 您的 API 密钥 |
action | refill_status |
refill | 单个补量 ID,即 action=refill 返回的 ID |
refills | 多个补量 ID,以逗号分隔,例如 1,2,3 |
order | 订单 ID,返回该订单最近一次补量的状态 |
orders | 多个订单 ID,以逗号分隔,返回每个订单最近一次补量的状态 |
响应
{
"status": "Completed"
}
响应(多个订单)
[
{ "refill": 1, "status": "Completed" },
{ "refill": 2, "status": { "error": "Refill not found" } }
]
可能的错误
| 消息 | 原因 |
Incorrect API key | 密钥不存在或不正确 |
Incorrect action | 未知的 action 值 |
Incorrect parameters | 未传入 service 或 link |
Incorrect service ID | 服务不存在或已停用 |
Incorrect order ID | 订单不存在或属于其他用户 |
Not enough funds on balance | 账户余额不足 |
No refill for this order | 此订单尚未申请补量 |
Refill not found | 该补量 ID 不存在或不属于您 |
示例(cURL)
curl -X POST https://smmstones.com/api/v2 \
-d key=YOUR_API_KEY \
-d action=add \
-d service=1 \
-d link=https://instagram.com/username \
-d quantity=1000