Documentation

Web service details

Method POST
Api address https://senatorgram.com/api/v1/
Your access key To receive the access key, you must register on the site.
Method
POST
Api address
https://senatorgram.com/api/v1/
Your access key
To receive the access key, you must register on the site.

products List

To view the product list, you must send a request that includes the following parameters to the address listed.
Parameter name Description
key Access key
action services
description This parameter is optional. If you want to get product descriptions, send the value Yes in this parameter
If the request is sent correctly, the product information of the site will be returned. Sample answer:
[
    {
        "service":"1", // barcode
        "name":"Instagram Follower - Server One",
        "type":"default", // Normal site products
        "category": "Instagram follower"
        "rate":"2500", //Price per thousand units in Tomans
        "min":"500", //Minimum number of products
        "max":"2000" //Maximum number of products
    },
    {
        "service":"2", // barcode
        "name":"Instagram comment (custom text)",
        "type":"comments", // Products that have a "Comments Text" field.
        "category": "Instagram comment"
        "rate":"2500", //Price per thousand units in Tomans
        "min":"500", //Minimum number of products
        "max":"2000" //Maximum number of products
    },
]

Add a new order

To place a new order, you must submit a request to the address above and use the following data in your request
Parameter name Description
key Access key
action add
service Product code that you can find on this page.
link Order link
quantity Number of orders
If the request is sent correctly, the order will be registered and the order code will be returned. Sample answer:
{
    "order":"23501"
}

Check the status of an order

To check the status of an order, you must send a request that includes the following parameters to the address listed.
Parameter name Description
key Access key
action status
order Order code
If the request is sent correctly, the order cost, counter start, status, remaining amount and currency will be refunded. Sample answer:
{
    "charge": "2000",
    "start_count": "324",
    "status": "Completed",
    "remains": "0",
    "currency": "Toman"
}

/*
    Order status:
    1- Pending
    2- Inprogress
    3- Processing
    4- Completed
    5- Canceled
    6- Partial
*/
   

Check the status of multiple orders

To check the status of multiple orders, you must send a request that includes the following parameters to the address listed.
Parameter name Description
key Access key
action status
orders Order code separated by commas (,)
If the request is sent correctly, the order cost, counter start, status, remaining amount and currency will be refunded. Sample answer:
{
    "1": {
        "charge": "2000",
        "start_count": "324",
        "status": "Completed",
        "remains": "0",
        "currency": "Toman"
    },
    "10": {
        "error": "Incorrect order ID"
    },
    "100": {
        "charge": "12400",
        "start_count": "672",
        "status": "Pending",
        "remains": "1200",
        "currency": "Toman"
    },
}
    

Receive account balance

To view account balance, you must send a request containing the following parameters to the address listed.
Parameter name Description
key Access key
action balance
If the request is sent correctly, the account balance and currency will be refunded. Sample answer:
{
    "balance": "359200",
    "currency": "Toman"
}