Get your credentials and learn how to authenticate with Floppydata
Floppydata uses two authentication methods depending on which product you’re using.
Authentication methods
| Product | Authentication | Format |
|---|
| Proxies | Username + Password | Passed in proxy connection string |
| Web Unlocker | API Key | Passed in X-Api-Key header |
| Client API | API Key | Passed in X-Api-Key header |
Getting your credentials
Navigate to settings
Click on your profile icon → Settings → API Keys & Credentials
Copy your credentials
You’ll see:For Proxies:Username: user_abc123xyz
Password: your_secure_password_here
API Key: floppy_live_1234567890abcdefghijklmnop
Click the copy icon to copy credentials to clipboard
Using proxy credentials
http://USERNAME:PASSWORD@geo.g-w.info:PORT
Example
http://user_abc123xyz:your_password@geo.g-w.info:10080
Available ports
| Port | Protocol | Use case |
|---|
10080 | HTTP | Default, works with most tools |
10443 | HTTPS | Secure HTTP connection |
10800 | SOCKS5 | Advanced use, automation tools |
Not sure which port? Start with 10080 (HTTP)
Adding Smart Parameters
Smart Parameters control proxy behavior. They’re added to the username:
USERNAME-parameter1-value1-parameter2-value2
user_abc123xyz-type-residential-country-US-session-mysession01
Learn more about Smart Parameters
See all available parameters and how to use them.
For Web Unlocker
Pass your API key in the X-Api-Key header:
import requests
headers = {
'X-Api-Key': 'floppy_live_1234567890abcdefghijklmnop',
'Content-Type': 'application/json'
}
response = requests.post(
'https://api.floppydata.net/v1/webUnlocker',
headers=headers,
json={'url': 'https://example.com'}
)
For Client API endpoints
Same format for all Client API requests:
curl -H "X-Api-Key: YOUR_API_KEY" \
https://api.floppydata.net/v1/rotating/balance
Testing your connection
Test proxy connection
Simple test with cURL:
curl -x http://USERNAME:PASSWORD@geo.g-w.info:10080 \
http://ip-api.com/json
{
"query": "123.45.67.89",
"country": "United States",
"city": "New York",
"isp": "ISP Name"
}
If you see a different IP than your own → Proxy is working!
Test API key
curl -H "X-Api-Key: YOUR_API_KEY" \
https://api.floppydata.net/v1/rotating/balance
{
"balance": 10.50,
"currency": "USD"
}
If you see your balance → API Key is working!
Quick setup examples
1. Install dependenciespip install python-dotenv requests
FLOPPY_USER=user_abc123xyz
FLOPPY_PASS=your_password
FLOPPY_API_KEY=floppy_live_1234567890abcdefghijklmnop
import os
import requests
from dotenv import load_dotenv
load_dotenv()
# For Proxy
proxy_url = f"http://{os.getenv('FLOPPY_USER')}:{os.getenv('FLOPPY_PASS')}@geo.g-w.info:10080"
proxies = {'http': proxy_url, 'https': proxy_url}
response = requests.get('http://example.com', proxies=proxies)
# For Web Unlocker / API
headers = {'X-Api-Key': os.getenv('FLOPPY_API_KEY')}
response = requests.post(
'https://api.floppydata.net/v1/webUnlocker',
headers=headers,
json={'url': 'https://example.com'}
)
1. Install dependencies2. Create .env fileFLOPPY_USER=user_abc123xyz
FLOPPY_PASS=your_password
FLOPPY_API_KEY=floppy_live_1234567890abcdefghijklmnop
require('dotenv').config();
const axios = require('axios');
// For Proxy
const proxy = {
host: 'geo.g-w.info',
port: 10080,
auth: {
username: process.env.FLOPPY_USER,
password: process.env.FLOPPY_PASS
}
};
axios.get('http://example.com', { proxy })
.then(response => console.log(response.data));
// For Web Unlocker / API
const headers = { 'X-Api-Key': process.env.FLOPPY_API_KEY };
axios.post(
'https://api.floppydata.net/v1/webUnlocker',
{ url: 'https://example.com' },
{ headers }
).then(response => console.log(response.data));
Managing API keys
Creating new keys
Navigate to API keys
Go to Dashboard → Settings → API Keys
Generate new key
Click “Generate New Key” and give it a descriptive name
Copy and store
Copy the key immediately (it won’t be shown again) and store securely
Rotating keys
Why rotate?
- Security best practice
- Compromised credentials
- Team member changes
- Regular maintenance
- Generate new API key
- Update your applications with new key
- Test that new key works
- Delete old key from dashboard
Deleting keys
Deleting a key immediately invalidates it. Update your apps first!
- Go to Dashboard → Settings → API Keys
- Find the key to delete
- Click Delete icon
- Confirm deletion
Troubleshooting
407 Proxy Authentication Required
Cause: Incorrect username or passwordSolutions:
- Double-check credentials in dashboard
- Ensure no extra spaces in username/password
- Try copying credentials again
- Check for special characters that need URL encoding
401 Unauthorized (API Key)
Cause: Invalid or missing API keySolutions:
- Verify API key in dashboard
- Check header name is exactly
X-Api-Key
- Ensure key hasn’t been deleted
- Generate new key if needed
Cause: IP whitelisting enabled but your IP not addedSolutions:
- Check if IP whitelisting is enabled (Dashboard → Settings)
- Add your current IP to whitelist
- Get your current IP:
curl https://api.ipify.org
Cause: Wrong host or portSolutions:
- Verify host is
geo.g-w.info (not .com or other variations)
- Check port: 10080 (HTTP), 10443 (HTTPS), or 10800 (SOCKS5)
- Check firewall settings
