Skip to main content

​
Endpoints

  • GET /v1/rotating/smartParamsCredentials
  • GET /v1/rotating/smartParamsBuilder
  • GET /v1/rotating/locations
  • GET /v1/rotating/balance
  • GET /v1/rotating/statistics

​
1. Fetch Base Credentials

curl --request GET \
  --url "$FLOPPY_BASE_URL/v1/rotating/smartParamsCredentials" \
  --header "X-Api-Key: $FLOPPY_API_KEY"

​
2. Build Smart Parameters Username

curl --request GET \
  --url "$FLOPPY_BASE_URL/v1/rotating/smartParamsBuilder?type=residential&country=US&city=New_York&rotation=15&protocol=http" \
  --header "X-Api-Key: $FLOPPY_API_KEY"
Supported query parameters include type, country, city, rotation, session, and protocol.
  • type must be residential, mobile, or datacenter.
  • rotation=-1 requests a new IP every request.
  • rotation=0 keeps the same IP within a session.
  • rotation=1..60 rotates after that many minutes.

​
3. List Available Locations

curl --request GET \
  --url "$FLOPPY_BASE_URL/v1/rotating/locations" \
  --header "X-Api-Key: $FLOPPY_API_KEY"

​
4. Check Traffic Balance

curl --request GET \
  --url "$FLOPPY_BASE_URL/v1/rotating/balance" \
  --header "X-Api-Key: $FLOPPY_API_KEY"
Response includes residential, mobile, and datacenter balances, each with subscription and nonExpiring data.

​
5. Query Usage Statistics

curl --request GET \
  --url "$FLOPPY_BASE_URL/v1/rotating/statistics?from=2026-03-01&to=2026-03-12&proxyType=residential&countryCode=US" \
  --header "X-Api-Key: $FLOPPY_API_KEY"
You can filter by from, to, poolId, proxyType, and countryCode.