Authentication
To authenticate your API requests, you must include your API key in the HTTP headers. You can find or generate your API key in the API Keys menu.
| Header Name | Description |
|---|
X-API-KEY | Your unique secret API key. |
Rate Limits
The current API rate limit is set to 60 requests per minute per IP address. Exceeding this limit will result in a 429 Too Many Requests response.
Traffic Generation Endpoint
Perform load testing and massive traffic generation. We support POST requests with a JSON body. Behind the scenes, we fully utilize Bright Data's Residential Proxy Network infrastructure. Our backend automatically generates and injects dynamic session IDs (e.g., -session-rand123-zone-) for each individual request. This guarantees a 100% unique, rotating IP address per request, perfectly mimicking legitimate human traffic and bypassing stringent IP rate limits or WAFs.
POST /api/traffic
Parameters (JSON Body)
| Parameter | Type | Required | Description |
|---|
url | String | Yes | The target URL to generate traffic for (e.g., "https://example.com"). |
count | Integer | Yes | Number of traffic requests to generate simultaneously. Each request autonomously rotates the Bright Data session to guarantee a unique IP. |
cURL Example (POST - JSON Body)
curl -X POST "https://uwstraffic.com/api/traffic" \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com", "count": 100}'
Python Example (Requests)
import requests
import json
url = "https://uwstraffic.com/api/traffic"
payload = json.dumps({
"url": "https://example.com",
"count": 100
})
headers = {
"Authorization": "YOUR_API_KEY",
"Content-Type": "application/json"
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.json())
Node.js Example (Fetch)
const fetch = require('node-fetch');
const url = 'https://uwstraffic.com/api/traffic';
const options = {
method: 'POST',
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ url: 'https://example.com', count: 100 })
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));
Response Format
A successful request returns a JSON object confirming the background traffic generation.
Response Schema
| Field | Type | Description |
|---|
success | Boolean | Indicates if the request was successfully queued. |
message | String | Status message indicating the number of requested traffics. |
Example Response
{
"success": true,
"message": "Background traffic generation started for 100 requests."
}
Model Context Protocol (MCP) Server
UWS Traffic provides a hosted MCP server, giving AI assistants (like Claude Desktop, Cursor, VS Code, Windsurf) direct access to real-time traffic generation and load testing without writing any integration code.
Prerequisites
- An API Key from your UWS Traffic dashboard.
- An MCP-compatible AI client.
Connecting to the Hosted Server
Configure your AI client's MCP settings to point to the UWS Traffic hosted server via SSE (Server-Sent Events). Use your API Key for authentication.
Claude Desktop Configuration (claude_desktop_config.json)
{
"mcpServers": {
"uws-traffic": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/client-cli",
"sse",
"--url",
"https://uwstraffic.com/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}
}
Cursor / VS Code / Windsurf
Go to MCP Server Settings in your IDE and add a new SSE-based MCP server:
- Type:
SSE
- URL:
https://uwstraffic.com/mcp?token=YOUR_API_KEY
Available Tools
| Tool Name | Description |
|---|
generate_traffic |
Generate massive web traffic to a target URL. This tool seamlessly integrates with Bright Data's proxy network, automatically applying session rotation per request to guarantee 100% IP anonymity and bypass WAF restrictions.
Arguments:
- url (string, required): The target URL to generate traffic for (e.g., https://example.com).
- count (integer, required): Number of traffic requests to generate simultaneously (Every request gets a unique IP).
|