Fetch - Floppydata Client API

Fetch a page with Web Data

curl --request POST \
  --url https://api.floppydata.net/v2/web-data/fetch \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "url": "https://example.com"
}
'

import requests

url = "https://api.floppydata.net/v2/web-data/fetch"

payload = { "url": "https://example.com" }
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({url: 'https://example.com'})
};

fetch('https://api.floppydata.net/v2/web-data/fetch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "html": "<!doctype html><html><head><title>Example Domain</title></head><body>...</body></html>",
  "sourceUrl": "https://example.com",
  "fetchedAt": "2026-06-10T12:00:00.000Z"
}

{
  "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
    }
  }
}

POST

https://api.floppydata.net

web-data

fetch

Fetch a page with Web Data

curl --request POST \
  --url https://api.floppydata.net/v2/web-data/fetch \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "url": "https://example.com"
}
'

import requests

url = "https://api.floppydata.net/v2/web-data/fetch"

payload = { "url": "https://example.com" }
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({url: 'https://example.com'})
};

fetch('https://api.floppydata.net/v2/web-data/fetch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "html": "<!doctype html><html><head><title>Example Domain</title></head><body>...</body></html>",
  "sourceUrl": "https://example.com",
  "fetchedAt": "2026-06-10T12:00:00.000Z"
}

{
  "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
    }
  }
}

This playground sends real production requests and can consume Web Data balance.

Authorizations

X-Api-Key

string

header

required

Client API key for the authenticated account.

Body

application/json

url

string<uri>

required

Target page URL to fetch through Web Data.

Example:

"https://example.com"

countryCode

string

2-letter country code for the request exit location.

Pattern: ^[a-zA-Z]{2}$

Example:

"US"

city

string

City for the request exit location.

Minimum string length: 1

Example:

"New York"

difficulty

enum<string>

Access difficulty pool. Defaults to the upstream default.

Available options:

low,

medium

Example:

"low"

cacheMaxAgeDays

integer

Maximum age of cached content in days.

Required range: 0 <= x <= 9007199254740991

Example:

0

Response

Fetched page HTML.

html

string

required

HTML content returned by the target page.

sourceUrl

string

required

Target URL that was fetched.

Example:

"https://example.com"

fetchedAt

string

required

ISO 8601 timestamp when the fetch completed.

Example:

"2026-06-10T12:00:00.000Z"