SGW API v2

Social Media Marketing Panel API Documentation

✓ Active← Back to Home

Overview

SGW API v2は、標準的なSMM Panel API形式に準拠したRESTful APIです。外部のSMMパネルシステムから、SGWが提供する多様なソーシャルメディアサービスにアクセスできます。

Base URL

https://socialgoodworld.com/api/v2

Features

36+ premium social media services
Multiple upstream providers (SBM, CHEAPPANEL, etc.)
SGW exclusive original services
Real-time order status tracking
Competitive pricing in JPY
Fast processing and delivery

Authentication

全てのAPIリクエストには、有効なAPIキーが必要です。APIキーは、SGWのダッシュボードから生成できます。

APIキーの取得方法

SGWにログイン
ダッシュボード → APIキー管理
「新規APIキー作成」をクリック
名前を入力して保存

Request Format

全てのリクエストはPOSTメソッドで送信し、JSON形式のボディに`key`パラメータを含めます。

{
  "key": "your_api_key_here",
  "action": "balance"
}

API Endpoints

Get Balance

現在の残高を取得します。

Request

POST https://socialgoodworld.com/api/v2
Content-Type: application/json

{
  "key": "your_api_key",
  "action": "balance"
}

Response

{
  "balance": "53254.97",
  "currency": "JPY"
}

Get Services

利用可能な全サービスのリストを取得します。

Request

POST https://socialgoodworld.com/api/v2
Content-Type: application/json

{
  "key": "your_api_key",
  "action": "services"
}

Response

[
  {
    "service": "1344",
    "name": "Instagram Likes ~ Indonesia [0-6hrs, No Refill]",
    "category": "🇮🇩 Instagram INDONESIA Services",
    "type": "likes",
    "rate": "3",
    "min": "100",
    "max": "10000",
    "desc": "High quality likes from Indonesia",
    "dripfeed": false,
    "refill": false,
    "is_original": false
  },
  {
    "service": "SGW_ORIGINAL_original_instagram_likes_jp",
    "name": "[SGW Original] ❤️手作り日本人いいね",
    "category": "🇯🇵インスタ日本人",
    "type": "Default",
    "rate": "12",
    "min": "10",
    "max": "200",
    "desc": "本物の日本人アカウントからのいいね",
    "dripfeed": false,
    "refill": false,
    "is_original": true
  }
]

📝 Service Fields

service: サービスコード（注文時に使用）
name: サービス名
rate: 単価（JPY）
min: 最小注文数量
max: 最大注文数量
is_original: SGWオリジナルサービスの場合true

Create Order

新しい注文を作成します。

Request

POST https://socialgoodworld.com/api/v2
Content-Type: application/json

{
  "key": "your_api_key",
  "action": "add",
  "service": "1344",
  "link": "https://instagram.com/your_account",
  "quantity": 100
}

Parameters

Parameter	Type	Required	Description
service	string	Yes	サービスコード
link	string	Yes	対象URL
quantity	number	Yes	注文数量

Response

{
  "order": "abc123def456",
  "charge": "300.00",
  "balance": "52954.97"
}

Get Order Status

注文のステータスを確認します。

Request

POST https://socialgoodworld.com/api/v2
Content-Type: application/json

{
  "key": "your_api_key",
  "action": "status",
  "order": "abc123def456"
}

Response

{
  "charge": "300.00",
  "start_count": "1000",
  "status": "completed",
  "remains": "0",
  "currency": "JPY"
}

Status Values

pending: 処理待ち
processing: 処理中
completed: 完了
partial: 一部完了
error: エラー

Error Handling

APIはエラー時に適切なHTTPステータスコードとエラーメッセージを返します。

Code	Error	Description
400	Bad Request	必須パラメータが不足しています
401	Unauthorized	APIキーが無効です
404	Not Found	サービスまたは注文が見つかりません
429	Too Many Requests	レート制限を超えました
500	Internal Server Error	サーバーエラーが発生しました

Error Response Format

{
  "error": "Error message description"
}

Code Examples

cURL

# Get Balance
curl -X POST https://socialgoodworld.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key":"your_api_key","action":"balance"}'

# Get Services
curl -X POST https://socialgoodworld.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key":"your_api_key","action":"services"}'

# Create Order
curl -X POST https://socialgoodworld.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{
    "key":"your_api_key",
    "action":"add",
    "service":"1344",
    "link":"https://instagram.com/account",
    "quantity":100
  }'

PHP

<?php
$api_url = 'https://socialgoodworld.com/api/v2';
$api_key = 'your_api_key';

// Get Balance
$data = [
    'key' => $api_key,
    'action' => 'balance'
];

$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo "Balance: " . $result['balance'] . " " . $result['currency'];
?>

Python

import requests
import json

api_url = 'https://socialgoodworld.com/api/v2'
api_key = 'your_api_key'

# Get Balance
data = {
    'key': api_key,
    'action': 'balance'
}

response = requests.post(api_url, json=data)
result = response.json()

print(f"Balance: {result['balance']} {result['currency']}")

# Create Order
order_data = {
    'key': api_key,
    'action': 'add',
    'service': '1344',
    'link': 'https://instagram.com/account',
    'quantity': 100
}

order_response = requests.post(api_url, json=order_data)
order_result = order_response.json()
print(f"Order ID: {order_result['order']}")

Node.js

const fetch = require('node-fetch');

const apiUrl = 'https://socialgoodworld.com/api/v2';
const apiKey = 'your_api_key';

// Get Balance
async function getBalance() {
  const response = await fetch(apiUrl, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      key: apiKey,
      action: 'balance'
    })
  });

  const data = await response.json();
  console.log(`Balance: ${data.balance} ${data.currency}`);
}

// Create Order
async function createOrder() {
  const response = await fetch(apiUrl, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      key: apiKey,
      action: 'add',
      service: '1344',
      link: 'https://instagram.com/account',
      quantity: 100
    })
  });

  const data = await response.json();
  console.log(`Order ID: ${data.order}`);
}

getBalance();
createOrder();

Rate Limits

APIの公平な使用を保証するため、レート制限を設けています。

Current Limits

✓ 60 requests per minute per API key
✓ 1000 requests per hour per API key
✓ 10000 requests per day per API key

レート制限を超えた場合、HTTP 429 (Too Many Requests) エラーが返されます。少し待ってから再試行してください。

Best Practices

リクエストをバッチ処理する
結果をキャッシュする（特にサービス一覧）
エラー時は指数バックオフを実装する
不要なポーリングを避ける

Need Help?

ご質問やサポートが必要な場合は、お気軽にお問い合わせください。

📧 Email Support

support@socialgoodworld.com

💬 Chat Support

Available 24/7 on dashboard