Authentication
Every request must include your API key, generated from your profile page. Three formats are accepted:
Authorization: Bearer YOUR_API_KEY X-API-Key: YOUR_API_KEY https://celebritualmarketplace.store/api/v1/balance?api_key=YOUR_API_KEY
Rate limits apply per key. Blocked keys, IPs or domains receive HTTP 403.
Account
Returns the account attached to the API key.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/profileRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
No parameters required.
curl -X GET "https://celebritualmarketplace.store/api/v1/profile" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": { "display_name": "Kendra", "balance": 25000 } }Live wallet balance in NGN.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/balanceRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
No parameters required.
curl -X GET "https://celebritualmarketplace.store/api/v1/balance" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": { "balance": 25000, "currency": "NGN" } }Wallet transactions, newest first.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/transactionsRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
| Name | Required | Description |
|---|---|---|
| limit | No | Max rows (default 50, max 200) |
curl -X GET "https://celebritualmarketplace.store/api/v1/transactions" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": [ { "type": "purchase", "amount": 1500 } ] }SMS Verification
Available SMS servers you can buy numbers from.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/sms/serversRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
No parameters required.
curl -X GET "https://celebritualmarketplace.store/api/v1/sms/servers" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": [ { "id": "server1", "name": "Server 1" } ] }Countries with live pricing for a server.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/sms/countriesRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
| Name | Required | Description |
|---|---|---|
| server_id | No | Filter by server |
curl -X GET "https://celebritualmarketplace.store/api/v1/sms/countries" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": [ { "country_code": "usa", "selling_price_ngn": 850 } ] }Apps available for a country with selling prices.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/sms/servicesRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
| Name | Required | Description |
|---|---|---|
| server_id | No | Filter by server |
| country_code | No | Filter by country |
curl -X GET "https://celebritualmarketplace.store/api/v1/sms/services" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": [ { "app_code": "wa", "app_name": "WhatsApp", "selling_price_ngn": 900 } ] }Debits your wallet and returns a phone number + activation ID.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
POST https://celebritualmarketplace.store/api/v1/sms/buyRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Body parameters
| Name | Required | Description |
|---|---|---|
| server_id | Yes | Server identifier |
| service | Yes | App/service code |
| country | Yes | Country code |
| price | Yes | Selling price shown by /sms/price |
curl -X POST "https://celebritualmarketplace.store/api/v1/sms/buy" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "server_id": "...", "service": "...", "country": "...", "price": "..." }'Example response
{ "success": true, "data": { "ok": true, "phone": "+1424...", "activation_id": "9931" } }Poll for the received verification code.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/sms/statusRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
| Name | Required | Description |
|---|---|---|
| activation_id | Yes | From /sms/buy |
curl -X GET "https://celebritualmarketplace.store/api/v1/sms/status" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": { "status": "code", "code": "483920" } }Cancels an unused activation and refunds the wallet.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
POST https://celebritualmarketplace.store/api/v1/sms/cancelRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Body parameters
| Name | Required | Description |
|---|---|---|
| activation_id | Yes | From /sms/buy |
curl -X POST "https://celebritualmarketplace.store/api/v1/sms/cancel" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "activation_id": "..." }'Example response
{ "success": true, "data": { "refunded": true } }Your SMS orders with codes and statuses.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/sms/ordersRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
No parameters required.
curl -X GET "https://celebritualmarketplace.store/api/v1/sms/orders" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": [ { "phone_number": "+1424...", "otp_code": "483920" } ] }Marketplace
Local and server-sourced products currently visible.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/marketplace/productsRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
| Name | Required | Description |
|---|---|---|
| q | No | Search text |
| limit | No | Max rows |
curl -X GET "https://celebritualmarketplace.store/api/v1/marketplace/products" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": { "products": [], "server_products": [] } }Visible marketplace categories.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/marketplace/categoriesRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
No parameters required.
curl -X GET "https://celebritualmarketplace.store/api/v1/marketplace/categories" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": [ { "name": "Social Logs", "slug": "social-logs" } ] }Real available stock for a product.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/marketplace/stockRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
| Name | Required | Description |
|---|---|---|
| product_id | Yes | Product UUID |
curl -X GET "https://celebritualmarketplace.store/api/v1/marketplace/stock" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": { "available_stock": 12, "total_stock": 40 } }Debits the wallet and returns the delivered credentials instantly.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
POST https://celebritualmarketplace.store/api/v1/marketplace/buyRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Body parameters
| Name | Required | Description |
|---|---|---|
| product_id | Yes | Product UUID |
curl -X POST "https://celebritualmarketplace.store/api/v1/marketplace/buy" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "product_id": "..." }'Example response
{ "success": true, "data": { "delivered": true, "content": "user:pass" } }Purchases a product supplied by a connected provider server.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
POST https://celebritualmarketplace.store/api/v1/marketplace/server-buyRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Body parameters
| Name | Required | Description |
|---|---|---|
| product_id | Yes | Server product UUID |
| quantity | No | Default 1 |
curl -X POST "https://celebritualmarketplace.store/api/v1/marketplace/server-buy" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "product_id": "...", "quantity": "..." }'Example response
{ "success": true, "data": { "status": "completed" } }Your marketplace orders and delivered content.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/marketplace/ordersRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
No parameters required.
curl -X GET "https://celebritualmarketplace.store/api/v1/marketplace/orders" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": [ { "product_name": "Netflix", "status": "completed" } ] }SMM / Boost
All enabled boosting services with limits and prices.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/smm/servicesRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
No parameters required.
curl -X GET "https://celebritualmarketplace.store/api/v1/smm/services" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": [ { "name": "Instagram Followers", "min_qty": 100 } ] }Creates a boosting order and debits the wallet.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
POST https://celebritualmarketplace.store/api/v1/smm/orderRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Body parameters
| Name | Required | Description |
|---|---|---|
| service_id | Yes | Service UUID |
| link | Yes | Target profile/post URL |
| quantity | Yes | Within service min/max |
curl -X POST "https://celebritualmarketplace.store/api/v1/smm/order" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "service_id": "...", "link": "...", "quantity": "..." }'Example response
{ "success": true, "data": { "order_id": "...", "status": "processing" } }Refresh status directly from the provider.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/smm/statusRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
| Name | Required | Description |
|---|---|---|
| order_id | Yes | Order UUID |
curl -X GET "https://celebritualmarketplace.store/api/v1/smm/status" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": { "status": "completed", "remains": 0 } }Requests a refill for a completed order.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
POST https://celebritualmarketplace.store/api/v1/smm/refillRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Body parameters
| Name | Required | Description |
|---|---|---|
| order_id | Yes | Order UUID |
curl -X POST "https://celebritualmarketplace.store/api/v1/smm/refill" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "order_id": "..." }'Example response
{ "success": true, "data": { "ok": true } }Your boosting orders.
Base URL
https://celebritualmarketplace.store/api/v1Full endpoint
GET https://celebritualmarketplace.store/api/v1/smm/ordersRequired headers
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Query parameters
No parameters required.
curl -X GET "https://celebritualmarketplace.store/api/v1/smm/orders" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Example response
{ "success": true, "data": [ { "service_name": "IG Likes" } ] }Error format
{ "success": false, "error": "Rate limit exceeded. Slow down.", "code": "rate_limited" }- 401 — missing or invalid API key
- 403 — key disabled, website not approved, or blacklisted
- 404 — unknown endpoint
- 429 — rate limit exceeded
- 503 — API disabled or in maintenance