|
Quick Navigation
1. Authentication
How to authenticate API calls using Bearer Tokens or key parameter
All requests to the MoahBoost SMM API must include your secret API Key. You can pass your key in two ways:
Method A: Body Parameter (Recommended)
Pass key=YOUR_API_KEY as a POST body parameter in form-urlencoded format.
POST key=YOUR_API_KEY&action=balance
Method B: Bearer Token Header
Pass your key as an Authorization HTTP header.
Authorization: Bearer YOUR_API_KEY
Security Guidelines
- Never expose your API key in client-side JS scripts, mobile apps, or public Git repos.
- Always make API calls from your backend server or cloud functions.
- If your API key is compromised, generate a new key immediately from your MoahBoost Account Settings.
2.
Services List
action=servicesRetrieve the complete list of available SMM services, pricing, min/max limits, and capabilities.
Endpoint:POST
https://moahboost.top/api/v1Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your secret API Key |
| action | string | Required | Must be set to "services" |
Request Example
bash
1curl -X POST https://moahboost.top/api/v1 \
2 -d "key=YOUR_API_KEY" \
3 -d "action=services"
Sample Success Response
json
1[
2 {
3 "service": 101,
4 "name": "Instagram Followers [Real & Active — Fast Delivery]",
5 "type": "Default",
6 "category": "Instagram - Followers",
7 "rate": "1.20",
8 "min": 100,
9 "max": 50000,
10 "dripfeed": true,
11 "refill": true,
12 "cancel": true
13 },
14 {
15 "service": 102,
16 "name": "Instagram Custom Comments [Verified Profiles]",
17 "type": "Custom Comments",
18 "category": "Instagram - Comments",
19 "rate": "3.50",
20 "min": 10,
21 "max": 1000,
22 "dripfeed": false,
23 "refill": false,
24 "cancel": false
25 }
26]
Possible Errors & Solutions
| Error Code | Reason | Resolution |
|---|---|---|
| "Incorrect API key" | The provided API key is invalid or inactive. | Verify your API key in Account Settings. |
| "Invalid action" | Action parameter is missing or misspelled. | Set action="services". |
3.
User Balance
action=balanceFetch your current wallet balance and account currency.
Endpoint:POST
https://moahboost.top/api/v1Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your secret API Key |
| action | string | Required | Must be set to "balance" |
Request Example
bash
1curl -X POST https://moahboost.top/api/v1 \
2 -d "key=YOUR_API_KEY" \
3 -d "action=balance"
Sample Success Response
json
1{
2 "balance": "184.50",
3 "currency": "USD"
4}
Possible Errors & Solutions
| Error Code | Reason | Resolution |
|---|---|---|
| "Incorrect API key" | Authentication failed. | Check your API key. |
4.
Add Order
action=addSubmit a new order for followers, views, likes, comments, or subscription services.
Endpoint:POST
https://moahboost.top/api/v1Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your secret API Key |
| action | string | Required | Must be set to "add" |
| service | integer | Required | Service ID from services list |
| link | string | Required | Target URL or profile handle |
| quantity | integer | Optional | Quantity needed (Required for Default service type) |
| runs | integer | Optional | Number of runs for Drip-feed |
| interval | integer | Optional | Interval in minutes between Drip-feed runs |
| comments | string | Optional | Newline-separated list of comments (for Custom Comments type) |
| usernames | string | Optional | Newline-separated list of usernames (for Mention / Scraper type) |
Request Example
bash
1curl -X POST https://moahboost.top/api/v1 \
2 -d "key=YOUR_API_KEY" \
3 -d "action=add" \
4 -d "service=101" \
5 -d "link=https://instagram.com/p/Example" \
6 -d "quantity=1000"
Sample Success Response
json
1{
2 "order": 982341
3}
Possible Errors & Solutions
| Error Code | Reason | Resolution |
|---|---|---|
| "Not enough balance" | Wallet balance is insufficient. | Deposit funds into your account wallet. |
| "Quantity must be greater than minimum" | Requested quantity is below service minimum. | Check service minimum limit. |
| "Quantity must be less than maximum" | Requested quantity exceeds service maximum. | Check service maximum limit. |
| "Link is required" | The link parameter was empty or invalid. | Provide a valid target URL. |
5.
Order Status
action=statusGet detailed progress, start count, remaining count, and cost for a single order.
Endpoint:POST
https://moahboost.top/api/v1Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your secret API Key |
| action | string | Required | Must be set to "status" |
| order | integer | Required | The unique Order ID returned during order placement |
Request Example
bash
1curl -X POST https://moahboost.top/api/v1 \
2 -d "key=YOUR_API_KEY" \
3 -d "action=status" \
4 -d "order=982341"
Sample Success Response
json
1{
2 "charge": "1.2000",
3 "start_count": "1540",
4 "status": "In progress",
5 "remains": "350",
6 "currency": "USD"
7}
Possible Errors & Solutions
| Error Code | Reason | Resolution |
|---|---|---|
| "Order ID is invalid" | Order ID was not found or does not belong to your account. | Verify the order ID. |
6.
Multiple Order Statuses
action=statusesQuery up to 100 order statuses simultaneously in a single API call to reduce bandwidth and rate usage.
7.
Request Refill
action=refillRequest a refill for an order that experienced drop-off within its refill guarantee window.
8.
Refill Status
action=refill_statusCheck the execution status of a submitted refill request.
9.
Cancel Order
action=cancelRequest cancellation for one or multiple pending/processing orders.
10. Global Error Responses
Complete reference of all standard error payloads returned by the API
When an API request fails, the response HTTP status code is typically 200 OK or 400 Bad Request with a JSON object containing an "error" field.
json
1{
2 "error": "Incorrect API key"
3}
| Error Message | Description | Recommended Fix |
|---|---|---|
| "Incorrect API key" | The API key was missing, misspelled, or revoked. | Check your key in Account Settings. |
| "Invalid action" | Action parameter is invalid or missing. | Use one of the supported actions (e.g. services, add, balance). |
| "Service not found" | The requested Service ID does not exist or is disabled. | Query action=services for active service IDs. |
| "Not enough balance" | Your wallet balance is lower than the order total charge. | Deposit funds via M-Pesa or Pesapal in your account. |
| "Quantity must be greater than minimum" | Order quantity is lower than service minimum. | Increase quantity to meet service min limit. |
| "Quantity must be less than maximum" | Order quantity exceeds service maximum limit. | Split order into multiple smaller requests. |
| "Link is required" | The link parameter was empty or missing. | Pass a valid post URL, channel link, or username. |
| "Order ID is invalid" | Order ID not found or belongs to another user. | Verify order ID from placement response. |
| "Rate limit exceeded. Please try again later." | Too many requests submitted within 60 seconds. | Slow down requests and use batch statuses. |
11. Rate Limiting & Best Practices
Limits, HTTP headers, and optimization strategies for high-volume resellers
Request Limit100requests / minute
Batch Query Cap100orders per statuses call
HTTP Status Code429Too Many Requests
Rate Limit Response Headers
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 84
X-RateLimit-Reset: 1723184000
Optimization Tips for SMM Resellers
- Use Batch Status Checking: Instead of making 50 individual calls to
action=status, combine order IDs into a singleaction=statuses&orders=1,2,3...request. - Cache Service Lists: Cache the result of
action=serviceslocally for 1–6 hours rather than requesting it on every order. - Implement Exponential Backoff: If you hit HTTP 429, wait 10 seconds before retrying failed requests.
Ready to Automate Your SMM Business?
Create an account or log in to get your instant MoahBoost API Key and start connecting your store today.