Ecommerce Search Results Snapshot avatar

Ecommerce Search Results Snapshot

Pricing

from $27.50 / 1,000 ecommerce search page rendereds

Go to Apify Store
Ecommerce Search Results Snapshot

Ecommerce Search Results Snapshot

Snapshot ecommerce onsite search results for queries and extract result counts, product tiles, filters, sort options, promoted items, no-results pages, and ranking positions.

Pricing

from $27.50 / 1,000 ecommerce search page rendereds

Rating

0.0

(0)

Developer

junipr

junipr

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

17 days ago

Last modified

Share

Snapshot ecommerce onsite search results for queries and extract result counts, product tiles, sort/filter options, promoted items, no-results pages, and ranking positions.

What it does

Renders public onsite-search pages and records query order, product tiles, numeric prices, availability, promoted labels, filters, no-results states, and optional screenshots.

The actor emits one row per visible product result, or a no-result/render diagnostic. Every dataset row uses the declared dataset schema, includes source provenance and a scan timestamp, and is written only after every applicable pay-per-event charge is accepted.

Typical uses

  • Snapshot onsite search results
  • Find no-results ecommerce queries
  • Audit search result merchandising
  • Export product rankings by query
  • Compare promoted and organic product tiles

Input

Use public HTTP(S) URLs or deterministic htmlInputs. URL fetching rejects localhost, loopback, link-local, and private-network destinations. allowedDomains can further constrain live fetches.

  • startUrls
  • sitemapUrls
  • htmlInputs
  • allowedDomains
  • maxPages
  • maxDepth
  • includeEvidence
  • includeRawSnapshots
  • requestDelayMs
  • timeoutMs
  • userAgentMode
  • siteSearchUrls
  • searchQueries
  • queryParamName
  • useSearchForm
  • maxResultsPerQuery
  • extractFilters
  • captureScreenshots
  • screenshotFullPage
  • viewportWidth
  • viewportHeight
  • maxSearchQueries
  • maxResultPages
  • maxProductResults
  • maxScreenshots
  • maxChargeUsd
  • includeReport

The safety caps named in maxSearchQueries, maxResultPages, maxProductResults, maxScreenshots, timeoutMs are enforced in addition to maxChargeUsd. A value of 0 for maxChargeUsd is a hard zero budget: the actor exits before the first paid operation.

Minimal deterministic example

{
"htmlInputs": [
{
"sourceUrl": "https://shop.example/public-page",
"html": "<html><head><title>Public page</title></head><body><h1>Public evidence</h1></body></html>"
}
],
"includeEvidence": true,
"includeReport": true,
"maxChargeUsd": 50
}

The prefilled input remains deliberately small so Apify automated quality runs finish quickly. For production use, replace the example source with public pages you are authorized to access.

Dataset output

  • sourceUrl
  • sourceType
  • pageTitle
  • recordType
  • recordName
  • issueCode
  • severity
  • evidenceSnippet
  • recommendation
  • canonicalUrl
  • httpStatus
  • scannedAt
  • query
  • searchUrl
  • resultCountText
  • resultPosition
  • productUrl
  • productTitle
  • price
  • availabilityStatus
  • promotedSignal
  • filterOptions
  • screenshotKey
  • noResults
  • rankingEvidence

Reports are also written to key-value storage:

  • ecommerce-search-results-snapshot-summary-report.md
  • ecommerce-search-results-snapshot-records.csv
  • ecommerce-search-results-snapshot-issues.json
  • ecommerce-search-results-snapshot-evidence-samples.json
  • ecommerce-search-results-snapshot-run-metadata.json

When includeRawSnapshots is true, bounded raw HTML snapshots are stored separately. Raw snapshots are off by default.

Pay-per-event pricing

Platform-usage pass-through is off. Prices are the locked fixed-inclusive values for this actor.

EventPriceMeaning
actor-start$0.08Actor Start
ecommerce-search-page-rendered$0.0275Ecommerce Search Page Rendered
product-result-record-extracted$0.0095Product Result Record Extracted
screenshot-captured$0.018Screenshot Captured
report-generated$0.18Report Generated

Charging rules:

  • actor-start must be accepted before fetching or rendering begins.
  • Page/target events are deduplicated per source.
  • Record and finding events fire only when the corresponding output exists.
  • Report output is written only after the report event is accepted.
  • Partial charges and Apify charge-limit responses stop the run before additional paid output.
  • Store discounts are tracked as a separate Console configuration requirement; this source does not claim they are already applied.

Evidence and failure behavior

  • URL-query and public search-form modes are supported.
  • The screenshot PPE event fires only after a real browser screenshot exists and before that PNG is stored.
  • Logged-in or personalized search states are out of scope.

A fetch failure, browser failure, blocked page, missing record, or incomplete match produces a bounded diagnostic row when possible. It never invents a successful extraction. Evidence can be omitted with includeEvidence: false.

Local verification

pnpm --filter @junipr/ecommerce-search-results-snapshot build
pnpm --filter @junipr/ecommerce-search-results-snapshot test
pnpm --filter @junipr/ecommerce-search-results-snapshot smoke

The tests cover strong, weak, unavailable, comparison, and cap fixtures; schema equality; pricing metadata; accepted/partial/limited charges; zero budget; and report generation.

Limitations

  • Results reflect the public source at the scan time and may change later.
  • Site markup changes can require selector/parser maintenance.
  • The actor does not bypass authentication, CAPTCHAs, robots restrictions, or access controls.
  • Legal, tax, pricing, SEO, merchandising, and marketplace decisions remain the user's responsibility.