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 traffic simulation. 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 unique, rotating IP address per request, perfectly mimicking legitimate human traffic and ensuring reliable data extraction.
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. |
interval | Integer | No | Interval in milliseconds between each cycle. For example, 1000 will delay 1 second between cycles. Default is 0. |
repeat | Integer | No | Number of times to repeat the cycle. Default is 1. Total requests = count * repeat. |
countries | Array[String] | No | List of ISO 2-letter country codes to target specific residential IPs (e.g., ["kr"] for South Korea Static/Residential IP). |
sessionId | String | No | [Anti-Ban Sticky Session] Fixed session identifier (e.g., "naver_acc_01"). Locks the residential/ISP proxy IP across requests so login sessions on Naver/Kakao are never flagged for IP switching. |
sticky | Boolean | No | If true, automatically maintains the same residential IP across all requests in the batch. |
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, "interval": 10000, "repeat": 3, "countries": ["us", "kr", "jp"]}'
Python Example (Requests)
import requests
import json
url = "https://uwstraffic.com/api/traffic"
payload = json.dumps({
"url": "https://example.com",
"count": 100,
"interval": 10000,
"repeat": 3,
"countries": ["us", "kr", "jp"]
})
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, interval: 10000, repeat: 3, countries: ['us', 'kr', 'jp'] })
};
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 simulated web traffic to a target URL. This tool seamlessly integrates with Bright Data's proxy network, automatically applying session rotation per request to guarantee reliable access and data extraction.
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).
- interval (integer, optional): Interval in milliseconds between each cycle.
- repeat (integer, optional): Number of times to repeat the traffic generation cycle.
- countries (array of strings, optional): List of ISO 2-letter country codes to target specific residential IPs. Supported: ae, ar, at, au, be, br, ca, ch, cl, cn, co, cz, de, dk, eg, es, fi, fr, gb, gr, hk, id, ie, il, in, it, jp, kr, mx, my, ng, nl, no, nz, ph, pl, pt, ru, sa, se, sg, th, tr, tw, ua, us, vn, za.
|