接口文档
请求方式 - 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;每批数量必须在该服务的最小值与最大值之间。
参数组合取决于服务类型 - 类型通过服务列表中的 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 - 用逗号分隔(批量)。批量请求的响应是「id → 结果」形式的对象。
| 参数 | 说明 |
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 返回 |
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