Overview - Floppydata Client API

Floppydata helps you use cloud browsers, Web Data, rotating proxies, static proxies, and account reporting from your own systems. The Client API is the programmatic layer for those jobs: automate a browser, search the web, fetch a page, build a proxy URL, check a proxy exit, list assigned static proxies, and keep an eye on balance and usage. If you are here in the middle of an integration, start small. Confirm your API key first, generate one connection string, check that proxy, then add the exact location, rotation, or reporting details your workflow needs.

Run the safe first request

Check account balances to confirm that your API key works before running traffic-consuming requests.

What You Can Do

Automate a Cloud Browser

Start a browser, connect over CDP, and reuse saved identity and browser state.

Search and Fetch Web Data

Discover relevant public pages, then fetch rendered HTML from a target URL.

Build proxy connections

Generate copy-paste rotating proxy URLs for HTTP clients, browser profiles, and automation tools.

Use static proxies

List assigned static proxies and copy their ready-to-use connection strings.

Track usage and balance

Read account-level and product-level balance and usage rollups.

How the Pieces Fit

Part	What it does
API key	Authenticates Client API requests through the `X-Api-Key` header.
Cloud Browser	Starts session-first browsers that you control with Playwright or Puppeteer.
Web Data	Searches for public pages or fetches a target page and returns rendered HTML.
Rotating proxy connections	Builds `connection.connectionString` values for rotating proxy traffic.
Static proxies	Lists assigned static proxy inventory and connection strings.
Proxy check	Tests a proxy URL and returns the observed `ip` and `location`.
Usage and balances	Shows remaining balance and recent UTC usage periods.

A Calm First Path

Create an API key

Open API keys, create or copy a Client API key, and keep it out of proxy connection strings.

Confirm access

Run GET /v2/account/balances. It is the easiest way to check that the key is valid.

Pick one workflow

Choose Cloud Browser for browser automation, Web Data to search for pages or fetch rendered HTML, or proxy connections if your own client will make the request through a proxy.

Copy the returned value

For proxies, use the returned connection.connectionString instead of rebuilding credentials by hand.

Watch usage

Use usage endpoints for yesterday, last7Days, last30Days, and optional requestedRange reporting.

Quickstart

Make the first useful v2 calls.

Use MCP

Give MCP-compatible agents Floppydata tools with one API key.

API Reference playground

Run live requests directly from endpoint pages.