REST Api Documentation

All requests should be be made to http://api.sbulkmarket.com/v1/, signed with auth_token.

Get Auth Token

Download the PHP-SDK. Remove .txt from the end of the filename before using it.
Make a HTTP POST request to the /order endpoint of the api to place a new order.

Required Parameters

service_id This parameter recognises the service you are trying to order. A list of service ID(s) can be found at the end of the page.
link This parameter is the link of the target page for the service.
quantity This parameter is the quantity service you are ordering.
auth_token This parameter is used to authenticate and recognises you. Not sending this token or sending an invalid token will result in a 401 Unauthorized response.

Code & Response Samples


require_once 'sbulksdk.class.php'; $response = (new SocialBulkMarket)->order(44, 'http://instagram.com/p/zw5tH1/', 1000); $orderId = $response['data']['order_id']; // store it in database for status enquiry & reference...

curl -X POST -H "Accept: application/json" -H "Content-Type: application/x-www-form-urlencoded" -d 'service_id=40&link=http%3A%2F%2Finstagram.com%2Fp%2Fzw5tH1%2F&quantity=200&auth_token=680fbebb141ac816734b8257c155f52eb70461f1' http://api.sbulkmarket.com/v1/order

Replace 680fbebb141ac816734b8257c155f52eb70461f1 with your actual auth token.


{ "code": 1, "message": "SUCCESS", "data": { "order_id": 3 } }

{ "code": 0, "message": "INVALID VALUE FOR ARGUMENT 'quantity'. MININUM ORDER : 100", "data": [ ] }
Make a HTTP GET request to the /order/{id} endpoint of the api to get status of an existing order. Here {id} should be replaced by the id of the order as returned by the previous method, at the time of placing order.

Required Parameters

auth_token This parameter is used to authenticate and recognises you. Not sending this token or sending an invalid token will result in a 401 Unauthorized response.

Code & Response Samples


require_once 'sbulksdk.class.php'; $orderId = 3; // In your app, you would obtain orderId from database. $response = (new SocialBulkMarket)->status($orderId); $status = $response['data']['status'];

curl -X GET http://api.sbulkmarket.com/v1/order/3?auth_token=680fbebb141ac816734b8257c155f52eb70461f1

Replace 680fbebb141ac816734b8257c155f52eb70461f1 with your actual auth token.


{ "code": 1, "message": "SUCCESS", "data": { "link": "http://instagram.com/p/zw5tH1/", "quantity": 1000, "status": "PENDING", "start_count": 0, "remaining_count": null } }

{ "code": 404, "message": "Order Not Found or Access Denied", "data": [ ] }

List of Active Services

Service ID Service Name

Possible Error Codes

HTTP Status Code Code in JSON Body Error Message Error Description
401 401 Unauthorized auth_token is either missing or invalid.
404 404 Order Not Found or Access Denied The order you asked, does not exist. If you try to access an order not made by you, the same error will be returned.
400 0 ARGUMENT MISSING : 'param_name' The parameter param_name is a mandatory parameter but is missing from the request.
400 0 INVALID VALUE FOR ARGUMENT 'param_name'. The value you supplied for param_name is invalid. Possible values or correction message is also supplied.
400 0 INSUFFICIENT 'balance'. REQUIRED BALANCE : $xx.xx Your account does not have sufficient balance to complete the order. The $xx.xx value denotes how much the current order would cost.