4.9 Rating by 50,000+ CustomersView Coupons
Developer API

SocialDriv API Documentation

Integrate SocialDriv's powerful SMM services directly into your own platform, website, or application. Our REST API is simple, reliable, and developer-friendly.

View Full Docs Get API Key
99.9%
Uptime SLA
< 50ms
Avg Response Time
17,000+
Services via API
REST
API Architecture

Authentication

All API requests require authentication using your unique API key. You can find your API key in your SocialDriv dashboard under the API Settings section.

Include your API key in every request either via the Authorization header or as a key parameter in the request body. Keep your API key confidential and never share it publicly. You can regenerate your API key at any time from your dashboard.

Security Best Practices
  • Store your API key in environment variables, never hardcode it in source code.
  • Use HTTPS for all API requests — unencrypted HTTP requests will be rejected.
  • Rotate your API key regularly and immediately if you suspect a compromise.
  • Implement rate limiting on your end — our API allows 60 requests per minute per key.
# Authentication example
curl -X POST https://api.socialdriv.com/api/v2 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "YOUR_API_KEY", "action": "balance"}'

Base URL

All API endpoints are accessible at the following base URL:

https://api.socialdriv.com/api/v2

All requests must be made via POST method withContent-Type: application/json. Responses are returned in JSON format.

Endpoints

The following actions are available via the API. Each request uses the same base URL with differentaction parameters.

POST/api/v2

Place Order

Submit a new order for a social media service.

Request
curl -X POST https://api.socialdriv.com/api/v2 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "key": "YOUR_API_KEY",
  "action": "add",
  "service": 123,
  "link": "https://instagram.com/username",
  "quantity": 100
}'
Response
{
  "order": 123456,
  "status": "pending",
  "charge": 2.50
}
POST/api/v2

Check Order Status

Retrieve the current status of an existing order.

Request
curl -X POST https://api.socialdriv.com/api/v2 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "key": "YOUR_API_KEY",
  "action": "status",
  "order": 123456
}'
Response
{
  "order": 123456,
  "status": "completed",
  "charge": 2.50,
  "start_count": 100,
  "remains": 200
}
POST/api/v2

List Services

Get a list of all available services with pricing.

Request
curl -X POST https://api.socialdriv.com/api/v2 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "key": "YOUR_API_KEY",
  "action": "services"
}'
Response
{
  "result": [
    {
      "service": 123,
      "name": "Instagram Followers",
      "rate": 2.50,
      "min": 10,
      "max": 10000,
      "category": "Instagram"
    }
  ]
}
POST/api/v2

Check Balance

Check your account balance.

Request
curl -X POST https://api.socialdriv.com/api/v2 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "key": "YOUR_API_KEY",
  "action": "balance"
}'
Response
{
  "balance": 150.00,
  "currency": "USD"
}

Order Statuses

When checking the status of an order, the API returns one of the following status values:

Status
Description
pending
Order received and awaiting processing
in_progress
Order is currently being processed and delivered
completed
Order has been fully delivered
partial
Order partially completed due to service limitations
cancelled
Order was cancelled (refund issued if applicable)
error
An error occurred — check order details or contact support

Error Handling

The API returns standard HTTP status codes and error messages to help you diagnose issues:

200Success

Request processed successfully.

400Bad Request

Missing or invalid parameters.

401Unauthorized

Invalid or missing API key.

403Forbidden

Insufficient balance or permissions.

404Not Found

Service or order not found.

429Rate Limit

Too many requests. Slow down.

500Server Error

Internal server error. Try again.

Example error response
{
  "error": "Invalid API key",
  "code": 401
}

Ready to Build?

Get your API key and full documentation — start integrating SocialDriv services in minutes.

View Full API Docs Create Account