curl --request POST \
--url https://api.floppydata.net/v2/proxy/rotating/connections \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"type": "residential",
"country": "US"
}
'import requests
url = "https://api.floppydata.net/v2/proxy/rotating/connections"
payload = {
"type": "residential",
"country": "US"
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({type: 'residential', country: 'US'})
};
fetch('https://api.floppydata.net/v2/proxy/rotating/connections', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"connection": {
"protocol": "socks5",
"host": "geo.g-w.info",
"port": 10800,
"username": "user-USERNAME-type-residential-session-my_session_1-country-US-state-california-asn-15169-rotation-15-udp-1",
"password": "PASSWORD",
"connectionString": "socks5://user-USERNAME-type-residential-session-my_session_1-country-US-state-california-asn-15169-rotation-15-udp-1:PASSWORD@geo.g-w.info:10800"
},
"parameters": {
"subuserId": 123,
"type": "residential",
"country": "US",
"state": "california",
"asn": "15169",
"rotation": 15,
"session": "my_session_1",
"protocol": "socks5",
"udp": true
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters.",
"details": {
"issues": [
{
"path": "country",
"code": "invalid_format",
"message": "Expected a 2-letter country code."
}
]
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized",
"details": {}
}
}{
"error": {
"code": "insufficient_balance",
"message": "Insufficient proxy traffic balance.",
"details": {}
}
}{
"error": {
"code": "forbidden",
"message": "Forbidden",
"details": {}
}
}{
"error": {
"code": "not_found",
"message": "Rotating proxy credential was not found.",
"details": {}
}
}{
"error": {
"code": "account_not_configured",
"message": "Account is not configured for proxy products.",
"details": {}
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"details": {}
}
}{
"error": {
"code": "upstream_error",
"message": "Failed to fetch data from an upstream service.",
"details": {
"upstreamStatus": 503
}
}
}Connections
Builds one rotating proxy connection string from dashboard-style options. Use connection.connectionString as the primary copy-paste value. Set subuserId to an ID from /v2/proxy/rotating/subusers, or omit it to use the first account subuser. Use locations first to choose valid country, city, and state values; state takes precedence over city.
curl --request POST \
--url https://api.floppydata.net/v2/proxy/rotating/connections \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"type": "residential",
"country": "US"
}
'import requests
url = "https://api.floppydata.net/v2/proxy/rotating/connections"
payload = {
"type": "residential",
"country": "US"
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({type: 'residential', country: 'US'})
};
fetch('https://api.floppydata.net/v2/proxy/rotating/connections', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"connection": {
"protocol": "socks5",
"host": "geo.g-w.info",
"port": 10800,
"username": "user-USERNAME-type-residential-session-my_session_1-country-US-state-california-asn-15169-rotation-15-udp-1",
"password": "PASSWORD",
"connectionString": "socks5://user-USERNAME-type-residential-session-my_session_1-country-US-state-california-asn-15169-rotation-15-udp-1:PASSWORD@geo.g-w.info:10800"
},
"parameters": {
"subuserId": 123,
"type": "residential",
"country": "US",
"state": "california",
"asn": "15169",
"rotation": 15,
"session": "my_session_1",
"protocol": "socks5",
"udp": true
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters.",
"details": {
"issues": [
{
"path": "country",
"code": "invalid_format",
"message": "Expected a 2-letter country code."
}
]
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized",
"details": {}
}
}{
"error": {
"code": "insufficient_balance",
"message": "Insufficient proxy traffic balance.",
"details": {}
}
}{
"error": {
"code": "forbidden",
"message": "Forbidden",
"details": {}
}
}{
"error": {
"code": "not_found",
"message": "Rotating proxy credential was not found.",
"details": {}
}
}{
"error": {
"code": "account_not_configured",
"message": "Account is not configured for proxy products.",
"details": {}
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"details": {}
}
}{
"error": {
"code": "upstream_error",
"message": "Failed to fetch data from an upstream service.",
"details": {
"upstreamStatus": 503
}
}
}connection.connectionString you can copy into an HTTP client, browser profile, or proxy checker.
The subuserId field is optional. Omit it to use your account’s default proxy credentials, or see Manage Rotating Proxy Subusers when you need separate proxy groups or replacement credentials.
For UDP, set protocol to socks5, choose residential or mobile, and set udp to true.Authorizations
Client API key for the authenticated account.
Body
Proxy type
residential, mobile, datacenter "residential"
2-letter country code.
^[a-zA-Z]{2}$"US"
Subuser ID from GET /v2/proxy/rotating/subusers. When omitted, the first account subuser is used.
x <= 9007199254740991123
City name from GET /v2/proxy/rotating/locations. Spaces are encoded as underscores. Used only when state is not supplied.
1"New York"
State or subdivision value from GET /v2/proxy/rotating/locations. When supplied, it takes precedence over city.
1"CA"
Target ASN as digits.
^\d+$"15169"
Rotation value: -1 for each request, 0 for sticky, or interval minutes.
15
1 - 128"my_session_1"
http, https, socks5 "http"
Route UDP traffic through the proxy. Supported only for SOCKS5 residential or mobile proxies.
false
Was this page helpful?