Home
Reseller API v1.0

ReqHit API Documentation

Sell hit bot services on your own platform using ReqHit infrastructure via RESTful API. All endpoints return JSON responses.

Base URL

https://api.reqhit.com/v1

Authentication

Bearer Token (JWT)

Format

JSON (UTF-8)

Rate Limit

Per-endpoint headers

Authentication

All API requests require a Bearer token via the Authorization header. Use /auth/token with your API key and secret to obtain a token.

# Include in every request:

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Content-Type: application/json

Authentication

POST/api/v1/auth/token
10/min

Get access token with API key

Parameters

ParameterTypeRequiredDescription
api_keystringYesAPI key from reseller panel
api_secretstringYesSecret key from reseller panel

Request Body

{
  "api_key": "rh_live_abc123def456",
  "api_secret": "sk_live_789xyz..."
}

Response (200 OK)

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "orders:read orders:write stats:read"
}

Order Management

POST/api/v1/orders
Auth 100/min

Create new hit order

Parameters

ParameterTypeRequiredDescription
target_urlstringYesTarget URL for hits (HTTPS required)
planstringYesPackage: starter, professional, enterprise
hits_per_minuteintegerNoHits per minute (default: plan limit)
proxy_countrystringNoISO 3166-1 alpha-2 country code
user_agent_typestringNodesktop, mobile, mixed (default: mixed)
cookie_enabledbooleanNoCookie simulation. Default: true
callback_urlstringNoWebhook URL for status changes

Request Body

{
  "target_url": "https://example.com",
  "plan": "professional",
  "hits_per_minute": 500,
  "duration_hours": 168,
  "proxy_country": "TR",
  "user_agent_type": "mixed",
  "cookie_enabled": true,
  "referer_urls": ["https://google.com"],
  "callback_url": "https://yoursite.com/webhook"
}

Response (200 OK)

{
  "id": "ord_7f3a8b2c1d4e",
  "status": "pending",
  "target_url": "https://example.com",
  "plan": "professional",
  "hits_per_minute": 500,
  "created_at": "2026-03-01T09:30:00Z",
  "expires_at": "2026-03-08T10:00:00Z",
  "estimated_cost_usdt": 349.00
}
GET/api/v1/orders
Auth 300/min

List all orders

Parameters

ParameterTypeRequiredDescription
statusstringNoFilter: pending, active, completed, cancelled
pageintegerNoPage number (default: 1)

Response (200 OK)

{
  "orders": [{ "id": "ord_xxx", "status": "active", "hits_delivered": 145230 }],
  "total": 1, "page": 1, "per_page": 20
}
GET/api/v1/orders/{id}
Auth 300/min

Get order details

Parameters

ParameterTypeRequiredDescription
idstringYesOrder ID (path parameter)

Response (200 OK)

{
  "id": "ord_xxx", "status": "active", "hits_delivered": 145230,
  "hits_total": 500000, "success_rate": 99.7, "unique_ips_used": 12847
}
POST/api/v1/orders/{id}/start
Auth 50/min

Start hit delivery

Parameters

ParameterTypeRequiredDescription
idstringYesOrder ID

Response (200 OK)

{ "id": "ord_xxx", "status": "active", "started_at": "2026-03-01T10:00:00Z" }
POST/api/v1/orders/{id}/stop
Auth 50/min

Pause hit delivery

Parameters

ParameterTypeRequiredDescription
idstringYesOrder ID

Response (200 OK)

{ "id": "ord_xxx", "status": "paused", "hits_delivered_so_far": 145230 }
DELETE/api/v1/orders/{id}
Auth 20/min

Cancel order

Parameters

ParameterTypeRequiredDescription
idstringYesOrder ID

Response (200 OK)

{ "id": "ord_xxx", "status": "cancelled", "refund_usdt": 125.50 }

Statistics & Reports

GET/api/v1/orders/{id}/stats
Auth 600/min

Real-time order statistics

Parameters

ParameterTypeRequiredDescription
idstringYesOrder ID
periodstringNorealtime, hourly, daily

Response (200 OK)

{
  "order_id": "ord_xxx", "hits_last_minute": 487, "hits_last_hour": 28420,
  "success_rate": 99.7, "unique_ips": 12847,
  "top_countries": [{ "country": "TR", "hits": 89000 }]
}
GET/api/v1/reports/daily
Auth 60/min

Daily summary report

Parameters

ParameterTypeRequiredDescription
datestringNoDate in YYYY-MM-DD format

Response (200 OK)

{
  "date": "2026-03-02", "total_hits": 1245000, "total_orders": 12,
  "total_spend_usdt": 2450.00, "avg_success_rate": 99.4
}

Account & Balance

GET/api/v1/balance
Auth 60/min

Query balance and credits

Response (200 OK)

{
  "balance_usdt": 1250.00, "credits_remaining": 5000000,
  "tier": "gold", "commission_rate": 0.40
}
GET/api/v1/proxies
Auth 30/min

Available proxy list

Parameters

ParameterTypeRequiredDescription
countrystringNoCountry code filter

Response (200 OK)

{
  "total_proxies": 50000,
  "countries": [{ "code": "TR", "count": 8500, "type": ["residential","isp"] }]
}

Webhook Management

POST/api/v1/webhooks
Auth 10/min

Register webhook URL

Parameters

ParameterTypeRequiredDescription
urlstringYesWebhook receiver URL (HTTPS required)
eventsstring[]YesEvent types to listen for
secretstringNoWebhook signing secret

Request Body

{
  "url": "https://yoursite.com/webhook",
  "events": ["order.started","order.completed","hits.milestone"],
  "secret": "whsec_xxx"
}

Response (200 OK)

{
  "id": "wh_abc123", "url": "https://yoursite.com/webhook",
  "status": "active"
}
DELETE/api/v1/webhooks/{id}
Auth 10/min

Delete webhook

Parameters

ParameterTypeRequiredDescription
idstringYesWebhook ID

Response (200 OK)

{ "message": "Webhook deleted successfully" }

Error Codes

CodeStatusDescription
400Bad RequestInvalid or missing request parameters
401UnauthorizedInvalid or expired token
403ForbiddenNo access to this resource
404Not FoundRequested resource not found
429Too Many RequestsRate limit exceeded. Check Retry-After header
500Internal Server ErrorServer error. Retry or contact support

Apply for API Access

After your reseller application is approved, your API keys and sandbox environment will be prepared.

Reseller Application[email protected]