API

Send every request as application/x-www-form-urlencoded. The key and action parameters are always required. Example PHP code · Generate API key

User balance

Example response

{
  "balance":  "100.84292",
  "currency": "USD"
}

Service list

Example response

[
  {
    "service":  "1",
    "name":     "Followers",
    "type":     "Default",
    "rate":     "0.90",
    "min":      "50",
    "max":      "10000",
    "category": "First Category"
  },
  {
    "service":  "2",
    "name":     "Comments",
    "type":     "Custom Comments",
    "rate":     "8",
    "min":      "10",
    "max":      "1500",
    "category": "Second Category"
  }
]

Add order

The add action accepts different parameter sets depending on the service type. Inspect type in the service catalog to pick the right payload.

Default

Example response

{ "order": 23501 }

SEO

Example response

{ "order": 23502 }

Custom Comments

Example response

{ "order": 23503 }

Custom Comments Package

Total quantity is computed server-side as posts × max; charge is billed at the upper bound and the undelivered slice is pro-rata refunded at completion.

Example response

{ "order": 23504 }

Poll

Example response

{ "order": 23505 }

Subscriptions

Subscription orders must be created from the customer site; API creation is not yet supported. Sending action=add with a subscription service ID returns HTTP 400 with a clear error message. Status / cancel / refill on an existing subscription still work normally through the API.

Invites from Groups

Example response

{ "order": 23507 }

Package

Package services have a fixed delivered quantity defined by the service itself — you only need to send the link.

{ "order": 23508 }

Order status

Example response

{
  "charge":      "0.27819",
  "start_count": "3572",
  "status":      "Partial",
  "remains":     "157",
  "currency":    "USD"
}

Possible status values: Pending In progress Partial Completed Done Canceled Failed

Multiple orders status

Example response

{
  "1": { "charge": "0.27819", "start_count": "3572", "status": "Partial", "remains": "157", "currency": "USD" },
  "2": { "error":  "Incorrect order ID" },
  "3": { "charge": "1.44219", "start_count": "234",  "status": "In progress", "remains": "10", "currency": "USD" }
}

Cancel the orders

Example response

[
  { "order": 9,  "cancel": { "status": "success" } },
  { "order": 2,  "error":  "Incorrect order ID" }
]

Error codes

Errors inside a 200 response always use {"error":"…"}.

Webhooks

Optional — configure a webhook URL on your account and we'll POST every order status change:

POST https://your-site.com/webhooks/order-update
Content-Type: application/json

{
  "order_id":    1487,
  "status":      "Completed",
  "remains":     0,
  "start_count": 8421,
  "charge":      4.5
}