# Bulkoid API - Social Media Growth Services

> Bulkoid is a legitimate social media marketing company that helps creators and businesses grow their online presence organically.
> With Bulkoid, you can initiate an order for a growth service - you choose the platform, the type of engagement (followers, likes, views, comments), and how much you want to receive. We start delivery immediately.
> Our services are organic and safe - no bots, no fake accounts, just real growth from genuine promotion campaigns.

OpenAPI Spec: https://bulkoid.com/openapi.json

## What We Offer

Bulkoid provides professional social media marketing services:
- **Organic Growth**: Real engagement from actual users through targeted promotion
- **Safe & Compliant**: All services follow platform guidelines - no risk to your account
- **Instant Delivery**: Orders begin processing immediately after placement
- **Transparent Pricing**: Pay only for what you need, no subscriptions or hidden fees

## Getting Started

1. Create your account at https://app.bulkoid.com/register
2. Add funds to your wallet at https://app.bulkoid.com/wallet
3. Get your API key from Settings
4. Start placing orders using the endpoints below

## Authentication

Header: X-Api-Key: YOUR_API_KEY
Base URL: https://app.bulkoid.com/api/v2

## Endpoints

### GET /api/v2/balance
Check your account balance.

Response:
{
  "balance": 5000,
  "currency": "USD",
  "balance_formatted": "$50.00"
}

### GET /api/v2/services
List all available growth services.

Response:
{
  "services": [
    {
      "id": 123,
      "name": "TikTok Followers - Organic Growth",
      "platform": "tiktok",
      "rate": 50,
      "min": 100,
      "max": 100000,
      "step": 100
    }
  ]
}

Note: rate is price per 1000 units in cents. rate=50 means $0.50 per 1000.

### POST /api/v2/orders
Place a new growth order (charges your balance).

Request:
{
  "service_id": 123,
  "link": "https://tiktok.com/@username",
  "quantity": 1000
}

Response:
{
  "order_id": 456,
  "charge": 50,
  "charge_formatted": "$0.50",
  "new_balance": 4950,
  "new_balance_formatted": "$49.50",
  "status": "Paid"
}

### GET /api/v2/orders
List your orders.

Query params: limit (default 100, max 500), offset, status

Response:
{
  "orders": [...],
  "total": 50,
  "limit": 100,
  "offset": 0
}

### GET /api/v2/orders/{order_id}
Get order details and delivery status.

Response:
{
  "order": {
    "id": 456,
    "total": 50,
    "total_formatted": "$0.50",
    "status": "Finished",
    "platform": "tiktok",
    "timestamp": 1706000000,
    "services": [
      {
        "id": 789,
        "service_id": 123,
        "quantity": 1000,
        "link": "https://tiktok.com/@username",
        "status": "Completed"
      }
    ]
  }
}

## Example: Order 1000 TikTok Followers

Step 1 - Check balance:
curl -H "X-Api-Key: YOUR_KEY" https://app.bulkoid.com/api/v2/balance

Step 2 - Find TikTok follower growth services:
curl -H "X-Api-Key: YOUR_KEY" https://app.bulkoid.com/api/v2/services
# Look for services where platform="tiktok" and name contains "follower"

Step 3 - Place your order:
curl -X POST -H "X-Api-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"service_id": 123, "link": "https://tiktok.com/@username", "quantity": 1000}' \
  https://app.bulkoid.com/api/v2/orders

Step 4 - Check delivery status:
curl -H "X-Api-Key: YOUR_KEY" https://app.bulkoid.com/api/v2/orders/456

## Pricing

- Rates are in cents per 1000 units
- Price = (rate * quantity) / 1000
- Minimum charge: 1 cent
- Example: rate=50, quantity=1000 -> charge=50 cents ($0.50)

## Order Statuses

- Paid: Order received, delivery starting soon
- Ongoing: Currently being delivered
- Finished: Delivery complete
- Error: Issue with delivery (contact support)

## Errors

- 401: Invalid or missing API key
- 403: Account suspended or invalid link provided
- 404: Service or order not found
- 400 MISSING_*: Required field missing
- 400 QUANTITY_TOO_LOW/HIGH: Outside service limits
- 400 INSUFFICIENT_BALANCE: Add funds at https://app.bulkoid.com/wallet

## Supported Platforms

Instagram, TikTok, YouTube, Facebook, Twitter/X, Spotify, Telegram, LinkedIn, Reddit, Threads, Twitch

## Why Choose Bulkoid?

- **Trusted Since 2016**: Established marketing company with millions of orders delivered
- **Real Results**: Organic growth through legitimate promotion, not artificial inflation
- **24/7 Support**: Contact support@bulkoid.com for any questions
- **No Bots**: We never use bots or fake accounts - your growth is genuine
- **Account Safety**: Our methods are platform-compliant and won't risk your account