Ecommerce Search Results Snapshot
Pricing
from $27.50 / 1,000 ecommerce search page rendereds
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
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
17 days ago
Last modified
Categories
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.
startUrlssitemapUrlshtmlInputsallowedDomainsmaxPagesmaxDepthincludeEvidenceincludeRawSnapshotsrequestDelayMstimeoutMsuserAgentModesiteSearchUrlssearchQueriesqueryParamNameuseSearchFormmaxResultsPerQueryextractFilterscaptureScreenshotsscreenshotFullPageviewportWidthviewportHeightmaxSearchQueriesmaxResultPagesmaxProductResultsmaxScreenshotsmaxChargeUsdincludeReport
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
sourceUrlsourceTypepageTitlerecordTyperecordNameissueCodeseverityevidenceSnippetrecommendationcanonicalUrlhttpStatusscannedAtquerysearchUrlresultCountTextresultPositionproductUrlproductTitlepriceavailabilityStatuspromotedSignalfilterOptionsscreenshotKeynoResultsrankingEvidence
Reports are also written to key-value storage:
ecommerce-search-results-snapshot-summary-report.mdecommerce-search-results-snapshot-records.csvecommerce-search-results-snapshot-issues.jsonecommerce-search-results-snapshot-evidence-samples.jsonecommerce-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.
| Event | Price | Meaning |
|---|---|---|
actor-start | $0.08 | Actor Start |
ecommerce-search-page-rendered | $0.0275 | Ecommerce Search Page Rendered |
product-result-record-extracted | $0.0095 | Product Result Record Extracted |
screenshot-captured | $0.018 | Screenshot Captured |
report-generated | $0.18 | Report Generated |
Charging rules:
actor-startmust 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 buildpnpm --filter @junipr/ecommerce-search-results-snapshot testpnpm --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.