Facebook Market API#
API mua bán tài khoản Facebook trên marketplace.
Base URL: https://app.socialking.vn/api/v1
1. Đăng bán Account#
POST /social/fb/market/create
#
Auth: Bearer Token (JWT)
Request Body:
{
"name": "Account Facebook VIA",
"uid": "100012345678901",
"type": "via",
"price": 50000,
"gender": "male",
"country": "VN",
"age": 25,
"year_created": 2020,
"account_data": {
"email": "account@example.com",
"password": "password123",
"cookie": "cookie_string",
"two_factor_secret": "2FA_SECRET"
},
"tagIds": [],
"proxyIds": []
}| Field | Type | Required | Validation |
|---|---|---|---|
name | string | Yes | 1-100 ký tự |
uid | string | Yes | 15-17 chữ số |
type | string | No | Default via |
price | number | No | >= 0, nullable |
gender | string | No | male | female | other |
country | string | No | 2 ký tự uppercase (ISO) |
age | number | No | 13-120 |
year_created | number | No | 2004 - năm hiện tại |
status | string | No | Default new |
account_data.email | string | No | Email hợp lệ |
account_data.password | string | No | Mật khẩu |
account_data.cookie | string | No | Cookie string |
account_data.two_factor_secret | string | No | 2FA secret |
account_data.phone | string | No | Số điện thoại |
account_data.notes | string | No | Max 1000 ký tự |
is_automation | boolean | No | Default false |
automation_expire | string | No | ISO 8601, phải là tương lai |
tagIds | UUID[] | No | Max 20 tags |
proxyIds | UUID[] | No | Max 5 proxies |
Response (201):
{
"success": true,
"data": {
"id": "uuid-string",
"name": "Account Facebook VIA",
"uid": "100012345678901",
"type": "via",
"price": 50000,
"status": "new",
"createdAt": "2026-03-30T10:30:00Z"
}
}2. Danh sách Market#
GET /social/fb/market/get-all
#
Auth: Bearer Token (JWT)
Query Parameters:
| Param | Type | Default | Mô tả |
|---|---|---|---|
_page | number | 1 | Trang |
_limit | number | 20 | Items/trang |
_order | string | desc | asc | desc |
_search | string | - | Tìm kiếm |
status | string | - | Filter theo status |
3. Mua Account#
POST /social/fb/market/purchase
#
Auth: Bearer Token (JWT)
Request Body:
{
"accountId": "uuid-account-id",
"quantity": 1
}| Field | Type | Required | Validation |
|---|---|---|---|
accountId | UUID | Yes | Account ID |
quantity | number | No | Default 1 |
4. Hủy đăng bán#
POST /social/fb/market/cancel/:id
#
Auth: Bearer Token (JWT)
URL Params: id (UUID)
5. Đăng bán hàng loạt#
POST /social/fb/market/bulk-create
#
Auth: Bearer Token (JWT)
Request Body:
{
"accounts": [
{
"name": "Account 1",
"uid": "100012345678901",
"price": 50000
}
]
}6. Hủy đăng bán hàng loạt#
POST /social/fb/market/bulk-cancel
#
Auth: Bearer Token (JWT)
Request Body:
{
"ids": ["uuid-1", "uuid-2"]
}