HstockPlus
HstockPlus/API Documentation
Login to get API key

Your API Key

Loading...

Test API

Select an action, fill in parameters, and send a request. When logged in, your API key is loaded automatically.

API Endpoint

https://hstockplus.com/api/v2

All API requests should be sent via HTTP POST to this endpoint.

Get Categories

Get all categories and each category's subcategories. Use these values to filter the Services List by category or subcategory.

ParameterDescriptionRequired
keyYour API keyYes
actioncategoriesYes

Example Request:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=categories"

Example Response:

{
  "categories": [
    {
      "category": "Instagram",
      "subcategories": ["Followers", "Comments", "Likes"]
    },
    {
      "category": "Email Accounts",
      "subcategories": ["Gmail", "Outlook"]
    }
  ]
}

Services List

Get all available services with optional pagination. Each service includes stock (available quantity). Optional category and subcategory parameters return only services in that category or subcategory (values from the Get Categories API).

ParameterDescriptionRequired
keyYour API keyYes
actionservicesYes
pagePage number (default 1). Used when limit > 0.No
limitItems per page (default 0 = return all).No
categoryFilter by category name (from Get Categories). Returns only services in this category.No
subcategoryFilter by subcategory name (from Get Categories). Returns only services in this subcategory.No

Example Request:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services"

With pagination:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "page=1" \
  -d "limit=50"

Filter by category or subcategory:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "category=Instagram"
# Or filter by subcategory:
curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "subcategory=Followers"

Example Response:

{
  "services": [
    {
      "service": 1,
      "name": "Instagram Followers",
      "type": "Default",
      "category": "Instagram",
      "rate": "0.50",
      "min": 100,
      "max": 10000,
      "refill": true,
      "cancel": false,
      "stock": 10000,
      "entityType": "smm",
      "autoDelivery": true
    },
    {
      "service": 2,
      "name": "Gmail Account - USA",
      "type": "Default",
      "category": "Accounts-Email",
      "rate": "25.00",
      "min": 1,
      "max": 50,
      "refill": false,
      "cancel": false,
      "stock": 50,
      "entityType": "product",
      "autoDelivery": true
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Each service includes stock (available quantity), entityType (smm or product), and autoDelivery (true if the service/product is auto-delivery, false if manual). When limit is 0 or omitted, all services are returned and page/limit equal total.

Check Inventory

Get current stock and availability for a service by its ID (same ID as in the services list).

ParameterDescriptionRequired
keyYour API keyYes
actioninventoryYes
serviceService ID (from services list)Yes

Example Request:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=inventory" \
  -d "service=23501"

Example Response:

{
  "service": 23501,
  "stock": 42,
  "available": true,
  "entityType": "product",
  "autoDelivery": true
}

Response includes entityType (smm or product) and autoDelivery (true = auto-delivery, false = supplier fulfills manually).

Add Order

Place a standard order with link and quantity. Link: for SMM services (e.g. followers, likes) — required, use the URL to the content (e.g. Instagram post); for product orders (e.g. accounts) — optional, if empty the system uses your account email for delivery.

ParameterDescriptionRequired
keyYour API keyYes
actionaddYes
serviceService IDYes
linkLink: For SMM orders (e.g. followers, likes, comments): required — URL or link to the content (e.g. Instagram post URL). For product orders (e.g. accounts): optional — delivery email or reference; if empty, the system uses your account email.No
quantityQuantity to orderYes

Example Request:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://instagram.com/username" \
  -d "quantity=1000"

Example Response:

{
  "order": 23501
}

Order Status

Get the status of an order.

ParameterDescription
keyYour API key
actionstatus
orderOrder ID

Example Request:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=23501"

Example Response:

{
  "status": "In progress",
  "charge": "5.00",
  "start_count": 1000,
  "remains": 500,
  "currency": "USD",
  "autoDelivery": true
}

For product orders (e.g. accounts), when the order is fully or partially delivered, the response includes an "accounts" array with the delivered account credentials (one string per account). For partial delivery, only the accounts delivered so far are returned.

autoDelivery: true if the order is fulfilled automatically (e.g. SMM, auto/inventory products); false if the supplier must fulfill manually (may take some time).

Example Response (product order with accounts delivered):

{
  "status": "Completed",
  "charge": "10.00",
  "start_count": 5,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": true,
  "accounts": [
    "user1:pass1",
    "user2:pass2"
  ]
}

Possible Statuses:

PendingIn progressCompletedPartialCanceled

Balance

Get your current balance.

ParameterDescription
keyYour API key
actionbalance

Example Request:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"

Example Response:

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

SMS Verification API

Dedicated endpoints for SMS verification services.

1. Get SMS Projects

Action: sms_projects

ParameterDescription
keyYour API key
actionsms_projects
countryOptional. Filter by country ID (e.g. 'us', 'gb')
[
  {
    "project_id": "65f...",
    "name": "OpenAI / ChatGPT",
    "price": "0.5000",
    "country_id": "us",
    "country_title": "United States"
  }
]

2. Get SMS Countries

Action: sms_countries

[
  {
    "country_code": "us",
    "country_name": "United States"
  },
  {
    "country_code": "gb",
    "country_name": "United Kingdom"
  }
]

3. Create SMS Order

Action: add_sms

ParameterDescriptionRequired
project_idProject ID from sms_projectsYes
quantityNumber of numbers (1-10)No (Default 1)
countryCountry code (e.g. 'us')No
phonePhone number to reuseNo
{
  "orders": [
    {
      "order": 12345,
      "phone": "+1234567890",
      "country": "us",
      "status": "active"
    }
  ]
}

4. Get SMS Code

Action: sms_code

ParameterDescription
orderOrder ID
{
  "status": "completed",
  "code": "123456",
  "sms_content": "Your verification code is 123456"
}
// OR
{
  "status": "waiting",
  "message": "Waiting for code"
}

5. Get SMS Order Status

Action: sms_status

{
  "status": "code_received",
  "phone": "+1234567890",
  "code": "123456",
  "charge": "0.5000",
  "currency": "USD",
  "expires_at": "2023-01-01T12:00:00.000Z"
}

Error Responses

Common error responses you may encounter.

{"error": "Invalid API key"}
{"error": "Invalid action"}
{"error": "Service ID is required"}
{"error": "Insufficient balance"}
{"error": "Order not found"}
{"error": "Service not found"}

Need help? Contact us at support@hstockplus.net

Supported payment methods

Supported payment methods