ScraperFlyAI-ready Web Data API

developer api

URL Content Parser API for public web pages

ScraperFly helps developers turn a public URL into usable page evidence: source HTML, rendered HTML, clean text, Markdown, metadata, screenshots, or PDFs for parser, AI, monitoring, and QA workflows.

URL to usable content

Send a public URL, inspect the response, and choose the content shape your product can use

A URL content parser sounds simple until the first target behaves differently from the sample. One page returns useful HTML. Another sends a thin JavaScript shell. Another redirects by region, hides content behind lazy loading, or gives your pipeline a page that looks successful but contains none of the fields the product needs.

ScraperFly gives teams a practical first step: send a public URL, capture the page, compare the response evidence, and return the format that fits the downstream workflow. Use HTML for custom parsing, text or Markdown for readable content, metadata for diagnostics, and screenshots or PDFs when humans need proof of the page state.

URL input HTML Markdown metadata visual proof
Developers reviewing URL content parser API response formats and page output workflow

What is a URL content parser API?

A URL content parser API accepts a public URL, retrieves the page, and returns a response shape that your application can inspect, parse, classify, index, monitor, or archive. The useful output might be source HTML, rendered HTML, clean text, Markdown, JSON metadata, a screenshot, or a PDF. The right choice depends on what the downstream system needs to do with the captured page.

ScraperFly handles the capture layer around that workflow. It can fetch public pages, run browser rendering when JavaScript creates important content, preserve response context, and return multiple output formats through one API surface. Your application still owns extraction rules, crawling strategy, field validation, enrichment, storage, and product-specific business logic.

That boundary is important. A URL parser should not hide where the content came from or pretend every page becomes perfect structured data automatically. Strong teams keep the response evidence visible so they can debug redirects, missing content, language changes, empty pages, blocked states, and template drift before those issues corrupt downstream data.

Practical takeaway: use a URL content parser API to standardize page capture and response formats, then build parsing logic around evidence your team can verify.

Which output should a URL parser return?

The best output is the smallest format that preserves what the product needs. A DOM parser needs markup. A search index may need clean text. An AI or RAG workflow may prefer Markdown with useful headings and links. A monitoring system may need metadata and visual evidence. Picking one output blindly usually creates cleanup work later.

ScraperFly lets teams test the same public URL with different formats before committing to production code. Compare source HTML, rendered HTML, text, Markdown, JSON metadata, screenshot, and PDF output on a few representative samples. If the simplest output contains the useful content, keep the request light. If it does not, add browser rendering or other request controls for the targets that prove they need it.

Output format Best suited to Main advantage Important limit
Source HTML Selectors, links, tables, metadata, custom extraction Preserves markup structure from the first response. May miss content created after JavaScript execution.
Rendered HTML SPAs, dynamic pages, client-side content, hydrated DOM Captures the page after browser execution. Heavier than a simple HTML request.
Text Search, indexing, lightweight analysis, summaries Compact and easy to process. Removes most DOM structure.
Markdown AI prompts, RAG, content review, documentation workflows Keeps readable headings, links, and lists. Not ideal for precise selector-based extraction.
JSON metadata Diagnostics, logs, response quality checks, routing decisions Shows request evidence such as status, final URL, and content type. Does not replace target-specific parsing.
Screenshot or PDF Visual QA, proof, archive records, compliance review Shows what the rendered page looked like. Heavier and harder to query automatically.

For a deeper comparison, use the web scraping API response formats guide. If your workflow begins with source markup, the HTML scraping API path is usually the cleanest first test. If useful content appears only after browser execution, compare results with the JavaScript rendering API.

How should teams validate a URL before scaling parsing?

A URL pattern can look stable while the content varies by redirect, language, page template, JavaScript behavior, geography, cookies, rate limits, or missing fields. Before scheduling thousands of requests, test a small set of real URLs and decide what counts as a usable response.

Look at final URL, status, content type, response size, source HTML, rendered HTML, visible screenshot state, and the fields your parser expects. If a URL returns a 200 status but the content is a login wall, empty shell, consent page, wrong locale, or fallback template, that response should not flow quietly into the same pipeline as a valid page.

ScraperFly’s value here is not only the returned content. It is the ability to keep request evidence and output choice close to the parser. Teams can test rendering, waits, sessions, headers, country targeting, and premium routing when the evidence shows a target needs them, rather than enabling everything by default.

Practical takeaway: define a usable response before volume: final URL, status, size, source shape, rendered state, and expected content should all make sense together.

Where does ScraperFly fit in a URL-to-content pipeline?

A production URL content workflow usually has several layers. The application decides which URLs matter. ScraperFly captures each public page and returns the chosen response shape. Your parser extracts fields or readable content. Your product then stores, indexes, compares, enriches, or sends the result to an AI pipeline.

Keeping those responsibilities separate makes the system easier to debug. If the parser misses a field, engineers can inspect the captured response. If JavaScript is required, rendering can be enabled for that target. If a page varies by region, country targeting can be tested. If a human needs visual confirmation, screenshots or PDFs can be attached to selected records.

Use the API Builder to test this before wiring production code. Paste a public URL, compare formats, and copy a request profile into cURL, Python, Node.js, Postman, or your backend. That turns parser design into an evidence-based decision instead of a guessing exercise.

How can URL content parsing stay affordable?

URL parsing costs become predictable when request weight matches the target. Many pages can be captured with simple HTML, text, or Markdown. Some need rendering because the useful content is browser-built. A smaller number need sessions, country routing, waits, visual proof, or stronger delivery. Treat those controls as targeted upgrades, not global defaults.

That is where ScraperFly’s credit model fits naturally. Start free, test representative URLs, understand which controls change the response, then choose pay-as-you-go credits or monthly credits when recurring volume becomes clear. For planning, review Pricing and estimate heavier workflows with the web scraping API credit cost calculator.

Parsing need Start with Add only when Cost-control move
Static page content Source HTML, text, or Markdown The first response lacks useful content. Keep this as the default for simple URL patterns.
JavaScript-built content Rendered HTML or rendered text/Markdown Source HTML is a thin shell or misses expected fields. Enable rendering per target, not globally.
Regional page variations Country or locale-aware samples The visible page changes by market, language, or currency. Store region context with every captured record.
Visual QA or proof Screenshot or PDF for selected records Humans need to verify the page state. Generate visual files only where proof matters.
Unstable delivery Response evidence and retry policy Status, size, final URL, or page state shows repeat failures. Escalate routing after evidence, not before.
Practical takeaway: the best URL parser workflow is not the heaviest workflow; it is the simplest repeatable request that returns content your product can trust.

URL content parsing

Turn a public URL into usable page content with the right response shape

ScraperFly helps teams start from a URL and choose the output that fits the job: HTML for custom parsing, text or Markdown for readable content, JSON metadata for diagnostics, and visual files for proof.

URL
Input

Start with a real URL sample

Verify status, final URL, content type, response size, and useful content before scaling a parser across many pages.

urlstatussamples
TXT
Output

Choose the content shape

Use HTML for selectors, text or Markdown for readable content, metadata for trust, and visual files when proof matters.

HTMLMarkdownmetadata
DOM
Rendering

Render only when content needs it

Enable browser rendering when a public page hides useful content behind JavaScript or hydration.

renderwaitsDOM

Controls that keep requests predictable

url

The target page to fetch, render, clean, or capture.

format

Select the response your product needs: html, text, markdown, json, screenshot, or pdf.

premium

Escalate to stronger routing for blocks, unstable targets, or geo-sensitive content.

render

Run Chromium for SPAs, JS-injected markup, screenshots, PDFs, and browser-only pages.

country

Request a country-specific route when content changes by location.

keep_headers

Forward selected request context such as user-agent, cookie, language, and referer.

render_wait

Give dynamic content a controlled extra wait before extraction or capture.

download

Return visual artifacts as downloadable files when the output is screenshot or PDF.

cURL example

Generate Markdown with the same request shape you can move into production

curl "https://scraperfly.com/api/v1?url=https%3A%2F%2Fexample.com&format=markdown" \
  -H "apikey: YOUR_API_KEY"

Target fit

Map page behavior before choosing content output

Good URL content parsing starts with target evidence: source HTML, rendered content, metadata, links, response size, redirects, geography, and session behavior. The response shape should be proven before the parser depends on it.

Raw HTML response mapped to visible page data
01

Raw HTML availability

Check whether the fields you need are already present in the first HTML response.

Best first test for simple pages, articles, docs, listings, and product details.

Before and after JavaScript rendering comparison
02

JavaScript dependency

Compare raw HTML with the rendered DOM or screenshot before turning on browser rendering.

Use rendering when raw HTML is only a shell and scripts create the useful content.

Cookies, consent, session and access context for scraping
03

State & access context

Identify whether cookies, consent, login boundaries, pagination, or the same visitor state affect the response.

Use sessions and headers when continuity changes the data you receive.

Regional content variations across countries and routes
04

Geo/content variation

Test whether country, language, currency, inventory, SERP, ads, or route reputation changes the result.

Use geo or premium routing only when the target proves the response varies by route.

Checks before parsing URL content

Where is the target field?

Find whether the field exists in raw HTML, rendered DOM, an API call, structured data, a file, or a later interaction state.

What changes the response?

Sample a few URLs and compare status, final URL, content length, redirects, empty states, and visible result differences.

What context is required?

Mark any dependency on consent, locale, cookies, headers, authentication boundary, pagination, filters, or previous requests.

What does failure look like?

Define the signals for blocked, partial, stale, redirected, empty, timed-out, or region-mismatched responses before scaling.

How target behavior changes the parser request

Fetch mode

Raw HTML availability decides whether the first request can stay simple or needs rendering, waits, screenshots, or extraction.

Request context

State requirements decide whether to add headers, cookies, sessions, consent handling, or a stable visitor profile.

Routing choice

Geo and reputation findings decide whether standard routing is enough or a country/premium route is justified.

Validation rules

Known failure states become checks for retries, escalation, QA review, and deciding when a lighter profile is still complete.

Practical parser path

Choose response evidence over one-size-fits-all URL parsing

Many parser tools make URL-to-content sound automatic, but production pages vary by JavaScript, template, redirects, language, and missing fields. ScraperFly gives developers the capture evidence and output choices needed to build a parser that can be inspected and improved.

Happy team validating a project on a laptop
01 / Start easy

Easy, free start before any billing pressure

ScraperFly gives you room to test the real target first. Use free credits to check whether the page works, whether the data is present, and which controls are actually needed before you commit money to a plan. That makes the first experiment feel light: no procurement loop, no forced subscription, no guessing your monthly volume on day one.

Free creditsNo card for first testsValidate before scaling
Smiling professional working successfully with a laptop
02 / Spend smart

Affordable, flexible billing for real-world scraping volume

Not every scraping workload is a neat monthly curve. Some projects spike, some pause, and some only become recurring after the data proves value. ScraperFly supports that reality with a pay-as-you-go path plus monthly credit plans when steady volume makes sense. You can buy what you need, keep costs visible, and avoid turning a small test into an oversized subscription.

Pay as you goMonthly when usefulCost control
Developer preparing structured output from a laptop
03 / Ship faster

Response preprocessing that removes cleanup work

A cheap fetch is not enough if your team still has to build converters, cleaners, screenshots, PDF capture, and LLM-ready formatting around it. ScraperFly can return the response as HTML, clean text, Markdown, structured JSON, PDF, or image output, so your pipeline gets closer to the final asset in one request. Less glue code, fewer moving parts, faster delivery.

HTMLTextMarkdownJSONPDFImage

Where ScraperFly wins against typical alternatives

The point is not to claim every competitor is bad. The point is fit: ScraperFly is the stronger choice when you want an API-first workflow, visible request controls, flexible credits, and response formats that help you ship instead of babysitting infrastructure.

Decision pointScraperFly advantageTypical competitor tradeoff
First experimentStart with free credits and validate the real target before spending. You can prove whether raw HTML, rendering, premium routing, or country targeting is actually needed.Trials often push you quickly toward a recurring plan or hide the true cost until add-ons enter the request.
Billing modelUse pay-as-you-go credits for uneven work, then move to monthly credits only when the workload becomes predictable. This keeps small tests and project-based scraping affordable.Many tools are optimized around monthly subscriptions, fixed allowances, or tier gates that can feel heavy before volume is proven.
Request weightKeep simple pages simple. Turn on JavaScript rendering, premium routing, sessions, headers, waits, or country routing only when the response evidence says they matter.Comparable controls may exist, but they are often bundled into higher tiers, defaults, or more complex pricing profiles.
Output formatsReturn the response in the shape your product needs: HTML for parsers, text or Markdown for content pipelines, JSON for structured metadata, and PDF/image output for visual proof.Some providers focus mainly on access and leave formatting, capture, cleanup, and downstream preparation to your own code.
Developer workflowOne API surface can cover target testing, escalation, rendering, routing, sessions, headers, response formatting, and status checks. The path from prototype to production stays compact.Proxy-first tools, actor marketplaces, and crawler platforms can be powerful, but often require more glue code or a heavier operating model.
Best fitTeams that want practical web data delivery: start small, measure cost per useful result, and scale only the controls that improve the outcome.Teams with fixed high-volume contracts, custom proxy infrastructure, or broad marketplace crawler needs may prefer a more specialized platform.

Efficient parsing

Keep URL parsing affordable by choosing the lightest useful output

Many URL parsing jobs can start with HTML, text, or Markdown. Rendering, routing, sessions, and visual outputs add value when they improve completeness or proof, but they should not become the default for every URL.

A lightweight HTML request returning a simple response
01

Basic fetch

Use a basic fetch when public HTML already contains the fields you need.

Lightest request profile; keep it when the response is complete.

JavaScript rendering producing a complete DOM
02

Rendering

Use rendering when raw HTML is a shell and JavaScript completes the page.

Heavier profile; use it only when browser output changes the result.

Several requests preserving cookies and visitor state
03

Stateful session

Use sessions when cookies, consent, locale, or pagination change the response.

Heavier state profile; preserve it only when continuity matters.

Request routing through geo and higher quality routes
04

Premium routing & geo

Use premium routing or geo only when origin, country, reputation, or regional content changes the result.

Heaviest routing profile; apply it only to targets that prove they need it.

What makes URL parsing heavier

More infrastructure work

Browser rendering, routing choices, and longer waits mean the platform has to do more than return a simple response.

More target uncertainty

Redirects, empty states, rate limits, and challenge pages often require stronger delivery options or retries.

More state to preserve

Cookies, sessions, consent, and multi-page flows add moving parts that a plain stateless fetch does not have.

More evidence to return

Screenshots, PDFs, rendered output, and richer response artifacts are useful, but they are heavier than plain HTML.

How to keep parser runs predictable

Sample before scale

Test a small URL set first and group targets by the lightest profile that returns complete data.

Do not render by default

Inspect raw HTML before turning on rendering. Many public pages already contain the data you need.

Escalate by evidence

Move up only when the response shows missing content, state dependency, geo variance, or routing problems.

Measure useful results

Optimize around valid records delivered, not raw request volume. A lighter profile is best only when it stays complete.

Parser questions

Common questions about URL content parsing

Practical answers for teams turning public URLs into page content for parsers, AI workflows, monitoring, QA, and archives without hiding response evidence.

Quick answers

URL to content workflow

For teams starting with a public URL and choosing the right response shape.

What is a URL content parser API?

It is an API workflow that accepts a public URL, captures the page, and returns content in a format your application can inspect, parse, classify, monitor, or archive.

Does ScraperFly write my extraction rules?

No. ScraperFly handles page capture, rendering, request controls, and response formats. Your application owns extraction rules, crawling strategy, enrichment, and storage.

Choosing the output

For teams comparing HTML, rendered HTML, text, Markdown, metadata, screenshots, and PDFs.

Which formats can ScraperFly return from a URL?

ScraperFly can return source HTML, rendered HTML, clean text, Markdown, JSON metadata, screenshots, and PDFs for supported public page workflows.

Is Markdown better than HTML for URL content parsing?

Markdown is often better for readable content, AI prompts, RAG, or review workflows. HTML is better when the parser needs selectors, attributes, tables, links, or DOM relationships.

Trusting the response

For teams validating URL samples before scaling parser runs.

When should I enable rendering for URL parsing?

Enable rendering when the useful public content is missing from source HTML and appears only after JavaScript runs in the browser.

What should I check before scaling a URL parser?

Check final URL, status, content type, response size, source HTML, rendered state, expected fields, and whether the output format matches the downstream system.

Proof and cost control

For workflows that need visual evidence or predictable recurring capture.

Can screenshots and PDFs help URL parsing workflows?

Yes, when humans need visual proof, QA evidence, compliance records, or archives. They complement machine-readable output rather than replacing it.

How can I control URL parser cost?

Start with the lightest useful output, add rendering or routing only when evidence shows they improve the response, and reserve visual files for records where proof matters.