{"uid":"cap_--xlsTf_tOxlK_Re-WYrJ","slug":"shopify-reviews-scraper-cc01eb39","name":"Shopify Reviews Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/shopify-reviews?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sortBy":{"enum":["newest","oldest","highest_rating","lowest_rating","most_helpful","pictures_first","videos_first","media_first"],"type":"string","default":"newest","description":"Order the collected reviews. Product summaries retain catalog order."},"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Stop after this many rows across all URLs. Zero means no overall cap."},"startUrls":{"type":"array","items":{"type":"string"},"description":"Public Shopify store homepages return product summaries; product URLs return individual reviews. Add one URL per line."},"verifiedOnly":{"type":"boolean","default":false,"description":"Keep only reviews explicitly marked as verified purchases."},"filterEndDate":{"type":"string","description":"Keep reviews published on or before this date, inclusive."},"filterKeyword":{"type":"string","description":"Keep reviews whose title or body contains this phrase, ignoring case."},"filterRatings":{"type":"array","items":{"enum":["1","2","3","4","5"],"type":"string"},"description":"Keep reviews with these ratings. Leave empty for all ratings."},"onlyWithMedia":{"type":"boolean","default":false,"description":"Keep only reviews with a photo or video URL."},"reviewContent":{"enum":["all","with_text","rating_only"],"type":"string","default":"all","description":"Include all reviews, reviews with written text, or ratings without text."},"onlyWithPhotos":{"type":"boolean","default":false,"description":"Keep only reviews with customer photo URLs."},"onlyWithVideos":{"type":"boolean","default":false,"description":"Keep only reviews with customer video URLs."},"filterStartDate":{"type":"string","description":"Keep reviews published on or after this date, inclusive."},"maxResultsPerUrl":{"type":"integer","default":50,"maximum":1500,"minimum":1,"description":"Maximum product summaries for each store URL or reviews for each product URL."},"merchantReplyOnly":{"type":"boolean","default":false,"description":"Keep only reviews with a public merchant reply."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"error":null,"status":null,"rowType":null,"inputUrl":null,"storeUrl":null,"productId":null,"storeDomain":null,"productHandle":null}],"product":"shopify-reviews"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xASCEhPV3ziO72DxabYrr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts and filters customer reviews from Shopify store pages or individual product URLs, returning structured review data with rich filtering options.","exampleAgentPrompt":"Pull the 100 most recent verified reviews for https://gymshark.com/products/mens-flex-training-shorts, only include ones with written text, sorted newest first, and stop if a review is older than 2024-01-01.","exampleUseCases":[{"title":"Competitor product sentiment analysis","prompt":"Scrape up to 200 reviews from https://allbirds.com/products/mens-wool-runners, filter to only 1 and 2 star ratings, include all review content, and sort by most helpful so I can understand what customers hate about this product."},{"title":"Influencer campaign review monitoring","prompt":"Get the last 50 reviews posted after 2024-06-01 on https://gfuel.com/products/collectors-box that mention the word 'unboxing', sorted by newest, so I can track what customers are saying after our influencer campaign launched."},{"title":"Store-wide product review summary","prompt":"Give me a summary of all products and their reviews from the Shopify homepage at https://puravidabracelets.com — pull up to 30 product summaries and only show reviews that include photos."}],"resultDescription":"Returns a JSON object with a count of results and an array of review items, each containing fields such as input URL, store URL, store domain, product ID, product handle, row type, status, and error. Individual review items include review text, rating, reviewer details, date, media URLs, verified purchase flag, and merchant reply when available.","failureModes":["Non-Shopify URLs return empty or error results but are not charged","Private or password-protected Shopify stores cannot be scraped","Invalid URL format causes request rejection","Overly restrictive filter combinations (e.g. verified + media + keyword + date) may return zero results","Rate limiting or bot protection on the target store may cause partial or empty results","Truncated or malformed product pages may yield incomplete review data"],"whenToPreferThis":"Choose this endpoint when you need structured, filtered review data specifically from Shopify-powered stores, with fine-grained control over sort order, date ranges, ratings, media presence, and keyword matching. It is ideal for competitive intelligence, sentiment analysis pipelines, or review monitoring workflows where manual scraping is impractical. Prefer this over generic web scrapers when the target is confirmed to be a Shopify store, as it returns semantically typed fields (productHandle, storeDomain, verified status) rather than raw HTML.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T04:16:08.233Z","isFirstParty":false,"canonicalSlug":"shopify-reviews-scraper-cc01eb39"}