Skip to main content

API Overview

The WeProxies API allows you to programmatically manage your proxy subscriptions, monitor usage, and access account information.

Base URL​

https://api.weproxies.com

Authentication​

All API requests require authentication using a Bearer token.

Getting Your API Token​

  1. Log in to WeProxies Dashboard
  2. Go to Settings → API Keys
  3. Generate a new API key

Using the Token​

Include the token in the Authorization header:

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.weproxies.com/api/v1/me

Response Format​

All responses are JSON formatted:

{
  "data": { ... },
  "success": true
}

Error Responses​

{
  "detail": "Error message here",
  "success": false
}

HTTP Status Codes​

CodeDescription
200Success
201Created
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing token
403Forbidden - Insufficient permissions
404Not Found
422Validation Error
429Rate Limited
500Internal Server Error

Rate Limiting​

API requests are rate limited to:

  • 100 requests per minute for standard endpoints
  • 10 requests per minute for resource-intensive operations

Rate limit headers are included in responses:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1699900000

Pagination​

List endpoints support pagination:

GET /api/v1/subscriptions?page=1&per_page=20

Response includes pagination metadata:

{
  "data": [...],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 45,
    "total_pages": 3
  }
}

Common Parameters​

ParameterTypeDescription
pageintegerPage number (default: 1)
per_pageintegerItems per page (default: 20, max: 100)
sortstringSort field
orderstringSort order: asc or desc

API Endpoints​

Account​

MethodEndpointDescription
GET/api/v1/meGet current user profile
GET/api/v1/me/balanceGet account balance

Subscriptions​

MethodEndpointDescription
GET/api/v1/subscriptionsList all subscriptions
GET/api/v1/subscriptions/{id}Get subscription details
GET/api/v1/subscriptions/{id}/usageGet usage statistics

Products​

MethodEndpointDescription
GET/api/v1/productsList available products
GET/api/v1/products/{id}Get product details

Usage​

MethodEndpointDescription
GET/api/v1/usageGet usage summary
GET/api/v1/usage/historyGet usage history

Example: Get Account Info​

curl -X GET "https://api.weproxies.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

Response:

{
  "data": {
    "id": "user_abc123",
    "email": "user@example.com",
    "balance": "50.00",
    "created_at": "2024-01-15T10:30:00Z"
  },
  "success": true
}

SDKs and Libraries​

We're working on official SDKs for popular languages. In the meantime, use the REST API directly with any HTTP client.

Community Libraries​

  • Python: Use requests or httpx
  • Node.js: Use axios or node-fetch
  • Go: Use net/http

Interactive Documentation​

Explore the full API with our interactive documentation:

👉 API Explorer

Need Help?​