Fetch a live page (or inline HTML) and return normalized text plus metadata.

Uses the existing `/checks` snapshot pipeline to pull a URL, parse the HTML, and return a trimmed text blob along with page metadata (title, description, domain, detected assets). Pass `html` in the JSON body when you already have the markup and want to skip the remote fetch.

GETPOST/web/page-text

Where this helper shines

Fetch a live page (or inline HTML) and return normalized text plus metadata. keeps web helpers on autopilot. Use it whenever you need to fetch a live page (or inline HTML) and return normalized text plus metadata without pausing a sprint or asking design/dev to jump in.

Trigger this helper whenever you need to fetch a live page (or inline HTML) and return normalized text plus metadata without waiting on a full deploy.
Drop it into automations (Zapier, Make, workers) to fetch a live page (or inline HTML) and return normalized text plus metadata as part of your workflow.
Share the GET URL so support and success can fetch a live page (or inline HTML) and return normalized text plus metadata safely using their Dataczar API key.

Copy & ship snippets

GET

Instant link

GET https://api.dataczar.app/web/page-text?url=https%3A%2F%2Fexample.com%2Fsample.png&limit=20&timeout=30&dryrun=true&ak=demo

Open directly in any browser, webhook, or low-code workflow.

curl

curl GET

curl "https://api.dataczar.app/web/page-text?url=https%3A%2F%2Fexample.com%2Fsample.png&limit=20&timeout=30&dryrun=true&ak=demo"

Swap ak=demo with your Dataczar API key.

curl

curl POST

curl -X POST "https://api.dataczar.app/web/page-text?ak=demo" \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://example.com/sample.png",
  "html": "<p>Example</p>",
  "limit": 30,
  "timeout": 40,
  "dryrun": true
}'

Send JSON payloads from back-end jobs, queues, or workers.

Parameters

Query Parameters

Name	Type	Description
url	string	HTTP/HTTPS URL to fetch when `html` is not supplied.
limit	integer	Maximum characters to include in the response text (default 4000).
timeout	number	Request timeout in seconds (default 5s).
dryrun	boolean	Return a summary instead of fetching the page.

All helper calls accept your Dataczar key via the ak query parameter. Need one? Create or copy a key on Dataczar Connect and drop it into each request.

Responses

Status 200

JSON envelope with normalized text and metadata.

{
  "ok": true,
  "data": {
    "result": {
      "text": "Launch your next Dataczar campaign with helper APIs...",
      "metadata": {
        "title": "Dataczar Helpers",
        "domain": "build.dataczar.com",
        "final_url": "https://build.dataczar.com/helpers",
        "description": "Catalog of image, text, and automation APIs.",
        "word_count": 1280,
        "stylesheets": [
          "https://cdn.dataczar.com/app.css"
        ],
        "scripts": [
          "https://cdn.dataczar.com/app.js"
        ]
      }
    }
  },
  "meta": {
    "dryrun": false,
    "service": "web/page-text"
  }
}

Examples

Test Contracts

[
  {
    "name": "inline_html",
    "method": "POST",
    "body": {
      "url": "https://example.com/demo",
      "html": "<html><h1>Demo</h1><p>Example page</p></html>"
    },
    "expect": {
      "ok": true
    }
  }
]

API key

HTTP method

Query parameters

url optionallimit optionaltimeout optionaldryrun optional

Body parameters

We'll send these as JSON for POST/PUT/PATCH requests and as query params for GET.

url optionalhtml optionallimit optionaltimeout optionaldryrun optional

Equivalent curl

Grab your Dataczar API key

Every helper runs with the same simple API key. Sign in (or create a free Dataczar account) at Dataczar Connect to issue keys in seconds, then drop the key into any `ak=` parameter and start shipping.

Get your API key Browse helpers

Tip: reuse the same key across these helpers, or rotate keys per project from the Connect dashboard.