API v2

Connect the API and get access to our services.

HTTP Method
— GET or POST
API URL
— https://bux.money/api/v2
Response format
— JSON

Service list

Параметры метода:

key
— Your API key
action
— services

Пример ответа:

[
  {
    "service": "12",
    "name": "Youtube 10sec video",
    "description": "Youtube 10sec video",
    "type": "default",
    "category": "Youtube",
    "rate": "24",
    "min": "10",
    "max": "110000",
    "refill": "0"
  }
]

Add order

Параметры метода:

key
— Your API key
action
— add
service
— Service ID (see services)
link
— Link to the video, channel or post
quantity
— Needed quantity, within min…max of the service
comments
— Comments, one per line. Required for «Custom Comments» services, otherwise «comments is required». Texts are taken as is (characters like «<3» are kept)
request_id
— Optional. Your request ID: letters, digits and ._:- up to 64 characters. A repeated request with the same ID returns the same order without a second charge

Video services (YouTube, Rutube views) and comment and subscription services for YouTube and VK accept orders. Services with comments written by a neural network answer «The service is temporarily disabled.» for now.

Video orders get a number with a prefix: {"order":"a123"}. Comment and subscription orders get a number: {"order":12345}.

Without request_id the same order (owner, service, link, quantity, comments, targeting) within 60 seconds inclusive returns the previous number without a second charge, unless that order was cancelled or deleted.

YouTube subscriptions: if the channel cannot be found by a channel link — «Не удалось получить информацию о канале. Укажите ссылку на канал в формате: https://www.youtube.com/channel/xxxxxxxxxx»; by a video link — «Не удалось получить информацию о канале»; an unparsed link — «Ссылка задана некорректно». start_count is 0 when the subscriber count is hidden.

At most 120 failed orders per hour per account after a link check (bad link, closed comments); after that «The service is temporarily disabled.» until the end of the hour. Orders without money, with field errors and when YouTube/VK are unavailable do not count.

Пример ответа:

{
  "order": 12345
}

Ошибки (текст message):

  • comments is required
  • Не удалось получить информацию о канале. Укажите ссылку на канал в формате: https://www.youtube.com/channel/xxxxxxxxxx
  • quantity must be >= N
  • quantity must be <= N
  • Insufficient funds on the balance sheet
  • Account is banned
  • service is undefined
  • request_id is incorrect
  • request_id already used with different parameters
  • The service is temporarily disabled.
  • Ссылка задана некорректно
  • Введите ссылку на видео
  • Комментарии к видео отключены
  • Комментарии закрыты!
  • Не удалось получить информацию по ссылке!
  • Не удалось получить информацию о канале
  • Сообщество закрыто!
  • Домен запрещен
  • banned words found
  • Сохранить задание не удалось, обратитесь в тех. поддержку

Order status

Параметры метода:

key
— Your API key
action
— status
order
— Order number: «a123» for video orders or 12345 for comment and subscription orders
orders
— Or several order numbers of both kinds separated by commas; the answer is an object keyed by order number

Statuses: In progress, Pending, Partial, stop, delete, completed (comment and subscription orders: In progress, Pending, Partial, stop, completed). currency is present only with the Partial status.

Пример ответа:

{
  "start_count": "1234",
  "remains": 80,
  "charge": 2.64,
  "count": "110",
  "status": "Partial",
  "currency": "RUB"
}

Cancel order

Параметры метода:

key
— Your API key
action
— cancel
order
— Order ID, or orders — several IDs separated by commas

Cancel stops the order (status becomes Partial). The unspent balance stays on the task: the owner takes it back in the dashboard by deleting the task with a refund.

Пример ответа:

{
  "cancel": "a123"
}

Complete a split order

Параметры метода:

key
— Your API key
action
— splitCompleted
order
— Order ID
total_count
— Total quantity actually needed

Only for video orders.

Пример ответа:

{
  "status": "ok",
  "total_quantity": "2500",
  "id": "123"
}

Speed up orders

Параметры метода:

key
— Your API key
action
— speedUpTasks
orders
— Order IDs without a prefix, separated by commas

Only for video orders.

Пример ответа:

{
  "speedUpCount": 1,
  "status": "ok"
}

Task statistics

Параметры метода:

key
— Your API key
action
— getStatTasks

Platform-wide statistics of YouTube tasks: active tasks, added today, added today and active, views, speed. All values are strings. If there are no active YouTube tasks, the answer is the error «no get info».

Пример ответа:

{
  "countActive": "1",
  "countAddToDay": "1",
  "countAddToDayandActive": "1",
  "countView": "110",
  "speed": "0"
}

User balance

Параметры метода:

key
— Your API key
action
— balance

Пример ответа:

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

Errors come as {"status":"error","message":"…"}: key is not valid, method unknown, no get info, Account is banned, service is undefined, quantity must be >= 10, Недостаточно средств.