ScraperFlyAI-ready Web Data API

use cases

Search Scraping API for public result pages

ScraperFly gives SEO, research, and intelligence teams a controlled capture layer for public search result pages. Preserve query context, result links, snippets, visible modules, rendered state, response metadata, and visual proof before downstream systems calculate rankings or insights.

Search result evidence

Capture the result page before your workflow interprets it

Search scraping is not just about collecting links. A public result page can include organic results, snippets, ads, images, videos, local modules, People Also Ask sections, news cards, shopping-style blocks, and layout changes that affect how a ranking should be interpreted. ScraperFly gives teams a controlled capture layer for those public pages before downstream systems parse, compare, enrich, or archive the evidence.

The practical advantage is separation. ScraperFly handles the request profile, rendering, routing controls, sessions, response formats, and visual proof. Your application handles ranking logic, keyword lists, dashboards, alerts, entity matching, and SEO methodology. That makes the page evidence easier to inspect and the business logic easier to change.

result evidenceSERP featuresvisual proof
Search operations team reviewing public search result page evidence in a plant-filled office

What is a search scraping API?

A search scraping API captures public search result pages and returns the response in a format your workflow can use. The captured page can then feed SEO monitoring, market research, content discovery, lead discovery, competitive intelligence, brand monitoring, or internal analysis. ScraperFly focuses on the capture layer: fetching the public page, applying the request controls that the target requires, and returning usable output such as HTML, rendered HTML, text, Markdown, JSON metadata, screenshots, or PDFs.

This matters because search pages are evidence-heavy. A downstream rank tracker or research tool needs to know what page was captured, which query and market produced it, what modules were visible, whether browser rendering changed the result, and whether the response looked complete. Without that context, a parser can turn a redirect, empty shell, soft block, or layout change into a misleading ranking movement.

Practical takeaway: use ScraperFly to capture the public result page clearly, then let your own workflow decide how to score, group, monitor, or act on the result evidence.

What search result evidence should teams capture?

A useful search record includes the query, market context, final URL, response status, result title, visible URL, snippet, rank, result type, source page, SERP feature, timestamp, and proof of what the page looked like when the sample was captured. For some workflows, the most important result is an organic link. For others, it is a featured snippet, local pack, People Also Ask module, image block, news result, paid placement marker, or a visual layout change.

ScraperFly helps preserve that evidence before the downstream system reduces it to metrics. HTML or rendered HTML supports custom parsers. Text and Markdown make review easier. JSON metadata adds operational context for logs and investigation. Screenshots or PDFs give visual proof when page layout affects the decision.

Evidence area Examples Why it matters
Query context Keyword, query URL, country, language, timestamp Shows which search context produced the captured page.
Result details Title, URL, snippet, position, visible source, result type Gives parsers the raw material for ranking and discovery workflows.
SERP features Ads, local packs, PAA, images, news, rich snippets, modules Explains why a position alone may not describe visibility.
Capture diagnostics Status, final URL, content type, response size, rendering state Separates real result changes from request or target failures.
Visual proof Screenshot or PDF of the public result page Helps verify layout, modules, sponsored markers, and disputed samples.

Why are search result pages harder than ordinary pages?

Search result pages are built around context and change. The same query can produce different layouts by country, language, device assumptions, timing, query wording, history-sensitive behavior, or visible search features. Some result pages expose enough HTML in the source response. Others require browser execution before useful modules appear. Some pages return a successful HTTP status while showing an interstitial, fallback page, empty shell, or layout that your parser does not expect.

The right response is not to make every request heavy. The right response is to sample representative queries, inspect the result evidence, and choose the smallest request profile that captures the useful page state. Raw HTML may be enough for some search pages. Rendering may be required for others. Country targeting, headers, sessions, or stronger routing should be added only when response evidence shows they improve capture quality.

Which response format works best for search scraping?

HTML is the most flexible starting point when your parser needs titles, links, snippets, modules, attributes, and page structure. Rendered HTML is useful when browser execution changes the result page. Text and Markdown are helpful when the first consumer is a reviewer, analyst, LLM workflow, or content research process. JSON metadata helps record the capture context. Screenshots and PDFs are valuable when visual layout matters or when a team needs a human-verifiable record of the page.

The best format depends on the downstream task. A rank extraction pipeline usually wants HTML or rendered HTML. A research review process may prefer Markdown. A monitoring system may store metadata with each parsed record. A QA or compliance workflow may keep screenshots only for samples that drive a decision.

Workflow Best starting format When to add visual proof
Rank extraction HTML or rendered HTML When mixed modules or sponsored blocks affect interpretation.
Content research Text or Markdown When snippets, questions, or visible layout need review.
Market intelligence HTML plus JSON metadata When result types or page layout become part of the finding.
Monitoring and QA HTML with diagnostics When a sample is disputed or a layout change matters.

How should rendering, routing, sessions, and headers be chosen?

Start with source capture, then compare. If raw HTML contains the result evidence, keep the request light. If the result page depends on browser execution, use rendering for that class of queries. If regional context changes the visible results, use country targeting or language headers. If continuity changes the response, use sessions. If repeated samples show delivery instability, evaluate stronger routing with response evidence rather than guesswork.

This keeps search scraping practical. Enabling every advanced control for every query can make the workflow slower, more expensive, and harder to diagnose. ScraperFly works best when teams classify page behavior: simple result pages, rendered result pages, regional result pages, visual-proof samples, and harder targets that need stronger delivery.

Useful setup references include the JavaScript rendering API, country targeting, custom headers scraping API, and sessions API.

What should stay downstream from ScraperFly?

ScraperFly should not be positioned as a complete SERP dataset, rank tracker, keyword database, or SEO alerting product. It captures public pages and returns supported response formats. Your own system decides how to store keywords, calculate positions, normalize layouts, identify result types, deduplicate domains, score opportunities, alert teams, or build dashboards.

That boundary is healthy for production workflows. A product team can change ranking logic without changing capture infrastructure. A research team can preserve visual proof only for important samples. An AI workflow can use Markdown while a parser keeps HTML. Each downstream consumer gets a cleaner input without forcing the scraping API to own every business decision.

How should teams start with ScraperFly?

Start with a representative sample set: one simple query, one query with rich modules, one market-sensitive query, one query likely to need rendering, and one result page that may require stronger delivery. Use the API Builder to compare output formats and request controls before writing production code. Keep the first request light, then add rendering, routing, sessions, headers, screenshots, or PDFs when the response proves they are needed.

Once the request profile is proven, scale by query class rather than applying one heavy default. Related pages can help refine the workflow: local SERP scraping, People Also Ask scraping, SERP rank tracking, and response formats. When recurring jobs grow, review pricing so request weight and check frequency stay aligned with the value of the search evidence.

Search scraping

Capture public search result pages with careful routing, pacing, and evidence

Search pages can be sensitive to repeated requests, location, language, device, rendering, and automation signals. ScraperFly helps teams test public result pages, inspect response quality, and add stronger delivery only where samples prove the need.

A simple HTTP request returning a clean HTML response
01

Plain HTML request

Use this first for public pages that already include the required data in the initial HTML.

A page changing from an empty HTML shell to a rendered DOM after JavaScript runs
02

JavaScript rendering

Enable rendering when the server returns a shell, but the useful page content appears only after JavaScript executes.

Headers, cookies and session state preserved across two requests
03

Headers, cookies & sessions

Use visitor-state controls when the target expects continuity between requests or returns different content after consent, locale, or navigation state is set.

A request routed through a selected country and higher reputation proxy path
04

Premium proxy & geo

Escalate routing when the response depends on request origin, IP reputation, or target geography.

A browser automation flow with search, filters, scrolling and data capture steps
05

Browser flow

Use a full browser flow when the data is behind interaction rather than a single request: search boxes, filters, scrolling, tabs, or multi-step navigation.

Escalate when:

01

Plain HTML request

the raw response contains the fields you need, status codes are stable, and page size/content do not collapse after repeated checks.

  • Product details, article text, documentation, or listings are visible in the HTML response.
  • The final URL, status, and content length stay consistent across a small sample.
  • No consent wall, visitor state, or client-side API call is required for the target fields.
02

JavaScript rendering

the raw HTML is mostly placeholders, the rendered DOM contains the target fields, or key data arrives through client-side requests.

  • Raw HTML has app containers, loading skeletons, or empty product grids.
  • Browser inspection shows the fields after scripts finish.
  • Screenshots look correct while the HTML response alone is incomplete.
03

Headers, cookies & sessions

pagination, reviews, filters, or consent flows depend on the same visitor context across multiple requests.

  • The first request sets cookies that change later responses.
  • Locale, consent, currency, cart, or filter state must be preserved.
  • The page redirects or empties out when requests look stateless.
04

Premium proxy & geo

the same URL behaves differently by region, returns 403/429 from one route, or shows location-specific pricing, availability, SERP, ads, or catalog data.

  • Datacenter-like traffic receives blocks while a higher-reputation route works.
  • Country, language, currency, inventory, or search results change by geo.
  • Repeated requests trigger rate limits or challenge pages on specific routes.
05

Browser flow

the target data appears only after user-like navigation steps, or protected areas such as reviews, profiles, search result refinements, or special data panels behave differently from simple detail pages.

  • A click, scroll, search, or filter action is required before the fields appear.
  • Reviews, profiles, or dynamic result pages load in separate steps.
  • Simpler fetch/render attempts return partial content, challenge pages, or unstable states.

Stay lower & Credit impact:

01

Plain HTML request

Stay lower: the page already returns complete data. Adding rendering or premium routing here only adds latency and credit usage without improving the result.

Credit impact: lowest request profile because it avoids browser work and special routing.

02

JavaScript rendering

Stay lower: the fields are already present in raw HTML. A modern-looking site does not automatically mean JavaScript rendering is needed.

Credit impact: higher than plain HTML because browser work, wait time, and page resources are involved.

03

Headers, cookies & sessions

Stay lower: public content is stable without state. Do not invent sessions for pages that can be fetched cleanly as anonymous HTML.

Credit impact: usually moderate; the bigger cost is operational complexity and retry discipline.

04

Premium proxy & geo

Stay lower: the target is globally consistent and accepts normal routing. Premium and geo routing should be tied to evidence, not used as a default blanket setting.

Credit impact: can increase credit usage and latency, so apply it to the URL groups that actually need it.

05

Browser flow

Stay lower: a single HTML or rendered request already returns the target. Browser flows are the strongest tool in this ladder, not the default starting point.

Credit impact: highest request profile because it combines browser runtime, waits, navigation, and often heavier routing.

Escalate by evidence, not by habit

  • For most public websites, a plain HTML request or light JavaScript rendering is enough. Start there, inspect the response, and only then decide whether the next step is justified.
  • Anti-bot signals are usually visible in the response: unexpected 403 or 429 statuses, sudden redirects, tiny or empty HTML, challenge pages, CAPTCHA screens, login or consent loops, and content that disappears after repeated requests.
  • Large high-traffic targets such as Amazon, Google, LinkedIn, Instagram, TikTok, and major marketplaces often protect some surfaces aggressively. They may require rendering, sessions, careful routing, or a browser flow, and each target needs its own test profile.
  • Protection is not uniform even inside one site. Product/detail pages may open with a lighter profile, while reviews, profiles, search pages, price-sensitive views, availability panels, or account-adjacent data can require stronger escalation.
  • Geo and premium proxy settings affect both what you receive and how expensive the request profile becomes. Use them when country-specific content, IP reputation, or repeated blocks prove they matter.
  • The practical goal is not to turn on every ScraperFly control. The goal is to find the sufficient level that returns complete, repeatable data while keeping credit usage, latency, and failure modes under control.

Search behavior

Map query, market, layout, and search features before extracting results

Search results can change by query wording, country, language, device, personalization signals, result type, ads, snippets, map packs, People Also Ask, and timing. Reliable capture starts with explicit context.

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 search scraping

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 search behavior changes scraping setup

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.

Search result fields

Collect result evidence that supports ranking, research, and discovery workflows

Useful search evidence can include query, market, result title, URL, snippet, rank, result type, visible features, timestamp, final URL, source page, and screenshot proof when layout matters.

Commerce

Turn public commerce pages into pricing and inventory intelligence

Track competitor prices, stock changes, sellers, marketplace offers, travel rates, and catalog shifts before they affect revenue.

Laptop with analytics charts for price monitoring
Commerce

E-commerce price monitoring

Watch competitor prices, discounts, stock status, shipping terms, and seller movement so pricing teams can react before market changes become invisible.

Useful fields: price, discount, stock, seller, shipping

Person browsing products on a smartphone
Commerce

Product catalog enrichment

Fill missing titles, descriptions, specifications, images, variants, and identifiers from public product pages and manufacturer catalogs.

Useful fields: title, description, specs, images, SKU

Large warehouse aisle representing marketplace operations
Commerce

Marketplace seller intelligence

Compare seller presence, fulfillment models, assortment depth, ratings, and offer changes across marketplaces.

Useful fields: seller, rating, offer, fulfillment, assortment

Warehouse worker organizing inventory shelves
Commerce

Inventory and availability tracking

Detect stockouts, pickup availability, regional inventory, delivery promises, and product availability gaps before customers do.

Useful fields: stock, region, pickup, delivery, timestamp

Person with shopping bags checking a smartphone
Commerce

Brand protection

Find unauthorized sellers, suspicious pricing, counterfeit signals, incorrect product claims, and risky listings in public marketplaces.

Useful fields: seller, price, claims, images, marketplace

Busy outdoor restaurant and hospitality scene
Commerce

Travel and hospitality monitoring

Collect room availability, rates, amenities, cancellation terms, local demand signals, and review context across booking surfaces.

Useful fields: rate, availability, amenities, policy, rating

Phone showing an online shopping interface
Commerce

Classifieds and secondhand tracking

Monitor new listings, asking prices, seller activity, item condition, location, and posting age across resale markets.

Useful fields: listing, price, condition, seller, location

Laptop showing financial graphs and analytics
Commerce

Price comparison and repricing

Turn competitor price snapshots into repricing inputs, assortment gaps, margin alerts, and market-position reports.

Useful fields: competitor, price, rank, availability, change

Growth

Find demand signals before they show up in your own analytics

Monitor search results, ads, competitor pages, business directories, hiring activity, and lead signals to see where attention is moving.

Laptop displaying analytics dashboard for SEO monitoring
Growth

SERP and SEO monitoring

Track ranks, snippets, ads, local packs, language, device, and geo differences to see how visibility changes in the real search surface.

Useful fields: rank, URL, snippet, ads, geo

Laptop open on a news or content page
Growth

Competitor content monitoring

Watch page changes, headings, CTAs, schema, internal links, and content inventory without waiting for manual audits.

Useful fields: heading, CTA, schema, links, updated text

Hands holding a phone with social media content
Growth

Ad intelligence

Collect public ad copy, creative patterns, landing pages, regions, timing, and advertiser activity for campaign research.

Useful fields: copy, creative, landing page, region, date

Business people exchanging documents in an office
Growth

Lead generation and company enrichment

Build account lists and enrich company records with domains, locations, industries, public contacts, hiring signals, and technology hints.

Useful fields: company, domain, industry, location, signals

Small local coffee shop storefront
Growth

Local business directory data

Collect names, categories, addresses, hours, websites, ratings, and review counts from public directory pages.

Useful fields: name, category, address, hours, rating

Office workers reviewing professional documents
Growth

Job market intelligence

Track job titles, skills, salary ranges, seniority, remote policies, and hiring velocity across career pages and job boards.

Useful fields: title, salary, skills, location, seniority

Voice

Turn public conversations into product and reputation signals

Collect reviews, media mentions, community discussions, public posts, and creator signals to understand what customers and markets are saying.

Person reading a newspaper while working on a laptop
Voice

News and media monitoring

Collect articles, authors, dates, topics, entities, links, and source metadata for reputation, research, and alerting workflows.

Useful fields: title, author, date, source, entities

People shopping and checking a smartphone together
Voice

Review and sentiment tracking

Capture rating trends, complaint themes, praise patterns, business responses, and product-location context from public reviews.

Useful fields: rating, review, theme, response, date

Person browsing a social media app on a smartphone
Voice

Social and public web monitoring

Monitor public posts, engagement, hashtags, timestamps, and profile context where policy and source access allow it.

Useful fields: post, engagement, hashtag, profile, time

Person reading news articles in a room
Voice

Community and forum intelligence

Find recurring questions, complaints, feature requests, and problem language from public communities and support forums.

Useful fields: question, topic, complaint, reply count, date

Workspace with laptop, coffee and newspaper
Voice

Creator and influencer discovery

Build discovery lists from public profile pages, content topics, audience hints, posting cadence, and collaboration signals.

Useful fields: profile, topic, audience signal, cadence, link

Records

Make public records and listings easier to monitor at scale

Extract tenders, legal notices, filings, financial data, and real estate listings into sourced datasets that teams can search, compare, and review.

Professionals exchanging business documents
Records

Public procurement and tenders

Track buyers, budgets, deadlines, requirements, attachments, awards, and changes across tender portals and public notices.

Useful fields: buyer, budget, deadline, requirements, award

Professionals discussing legal documents in an office
Records

Regulatory and legal monitoring

Monitor notices, public registers, effective dates, document versions, affected entities, and compliance-relevant changes.

Useful fields: notice, entity, date, document, status

Professionals reviewing financial documents
Records

Financial and public market research

Collect filings, disclosures, tables, news, instrument metadata, and public financial context for research pipelines.

Useful fields: filing, table, issuer, date, metric

House keys and cash for real estate market data
Records

Real estate listings and market data

Track listing prices, addresses, property attributes, agent details, status, history, and neighborhood context.

Useful fields: price, address, beds, agent, status

Data products

Build data products from scraped pages, not page dumps

Clean, normalize, validate, enrich, compare, and deliver public web data into databases, dashboards, alerts, and LLM pipelines.

Laptop screen with programming code
Data products

LLM-ready web data pipelines

Convert public pages into clean text, Markdown, chunks, metadata, citations, and freshness signals for retrieval or model workflows.

Useful fields: clean text, Markdown, chunk, source URL, timestamp

Data center server racks for database workflows
Data products

Structured extraction to database

Turn HTML, PDFs, tables, and page text into typed records that can be stored, queried, joined, and audited later.

Useful fields: JSON, type, source, schema, record ID

Laptop with coding and data analysis interface
Data products

Change detection and alerting

Compare snapshots and alert teams when prices, stock, rank, content, status, or regulatory language changes.

Useful fields: previous value, new value, delta, threshold, alert

Computer screen with colorful code and data
Data products

Entity enrichment and normalization

Normalize product IDs, company names, locations, people, categories, units, currencies, and taxonomy mappings.

Useful fields: entity, canonical ID, category, unit, confidence

Close-up of server rack with blue indicators
Data products

Data quality validation

Check required fields, data types, ranges, duplicates, source evidence, and suspicious records before downstream use.

Useful fields: required field, type, range, evidence, confidence

Laptop with code editor for data reporting feed
Data products

Reporting and dashboard feeds

Feed BI dashboards, market reports, operating scorecards, and recurring analyses with web data that refreshes on schedule.

Useful fields: metric, dimension, period, source, refresh

Why ScraperFly

Keep search capture modular while query and market behavior are still being learned

Flexible credits and visible request controls help teams test routing, rendering, output formats, and proof needs before scaling.

  • Fill gaps left by APIsMany sources expose useful public pages but no complete API for the exact fields, geos, filters, or histories a team needs.
  • Monitor change over timeRecurring scrapes create a history of prices, content, availability, ranks, reviews, notices, and market movement.
  • Compare across sourcesScraping makes cross-site comparison possible when marketplaces, directories, portals, and publishers structure data differently.
  • Create usable recordsThe useful output is not a page dump; it is a sourced, timestamped, normalized record that downstream systems can trust.
Best fit

Useful for SEO monitoring, market research, content discovery, lead discovery, and SERP analysis

Teams can test query groups and markets before building recurring search monitoring or extraction workflows.

One API for varied sources

Use the same integration pattern across stores, search pages, directories, documents, public listings, and data-product pipelines.

Delivery controls when needed

Rendering, sessions, headers, geo, and proxy routing can be added for targets that need them without rebuilding the workflow.

Output that supports post-processing

HTML, screenshots, clean text, Markdown, and structured extraction paths help teams move from page retrieval to usable records.

Less scraping infrastructure to own

Teams can focus on fields, validation, freshness, and business logic instead of browser fleets, routing edge cases, and retry plumbing.

Search request builder

Build search scraping requests with query context, output format, and delivery controls aligned

Use HTML for custom SERP parsing, text or Markdown for readable result review, JSON metadata for enrichment, and screenshots when result layout or visible features need proof.

QRY
Query context

Preserve query, market, and result layout

Search data only makes sense when the query and market context are tied to the captured result page.

querycountrylanguage
SERP
Features

Capture result types and visible search modules

Organic results, ads, snippets, local packs, and question modules can all change what a rank means.

rankfeaturessnippets
QA
Proof

Use screenshots when the SERP layout drives decisions

Visual capture helps verify result modules, sponsored placements, local packs, and market-specific layouts.

screenshotrender

Controls that shape search scraping

url

The public search result page or query URL being captured.

country

Regional routing for market-specific result pages.

format

The output shape for parsing, review, or proof.

premium

Stronger routing for search pages that resist simple delivery.

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"

Search FAQ

Common questions about search result scraping workflows

Practical answers for teams capturing public result pages, visible SERP features, query context, response evidence, and visual proof.

Search answers
Scope

Capture layer boundaries

Questions about what ScraperFly captures and what belongs downstream.

Does ScraperFly provide a SERP dataset?

No. ScraperFly captures public pages in supported formats. Ranking logic, keyword databases, alerts, and dashboards remain downstream responsibilities.

Can ScraperFly calculate rankings automatically?

ScraperFly returns source evidence. Your application should parse positions, normalize modules, and apply its own ranking rules.

Output

Formats and proof

Questions about machine-readable output and visual records.

Which formats are useful for search scraping?

HTML supports custom parsers, text and Markdown support review, JSON metadata helps inspect page context, and screenshots or PDFs preserve visual proof.

When should screenshots be stored?

Use screenshots for disputed samples, rich layouts, sponsored markers, local packs, or result pages where visual placement affects interpretation.

Controls

Rendering and routing

Questions about request settings for changing result pages.

Can ScraperFly capture JavaScript-rendered search pages?

Yes. Use rendering when the useful result content or layout requires browser execution.

Can routing controls help search capture?

Yes. Country targeting, sessions, selected headers, and premium routing can help when public result pages vary by location or request context.

Operations

Validation and scaling

Questions about comparing samples without creating noisy reports.

How should teams validate search scraping workflows?

Test representative queries, compare raw and rendered output, preserve visual proof for tricky layouts, and keep extraction logic separate from capture.

Should every query use the same heavy request?

No. Classify query and page behavior, then reserve rendering, screenshots, premium routing, or sessions for samples that prove the need.