{ "openapi": "3.0.1", "info": { "title": "Capterra Reviews Scraper – Ratings, Pros & Cons", "description": "Scrape Capterra software reviews by product URL, name or category: ratings, pros and cons, comments, vendor reply, reviewer job title, country, industry and company size. Goes past 10,000 reviews per product. Filter by stars, company size, country and dates; monitor new reviews. JSON, CSV or Excel.", "version": "0.0", "x-build-id": "SOBOVWilN9bBDwtZ1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nice_dev~capterra-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nice_dev-capterra-reviews-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/nice_dev~capterra-reviews-scraper/runs": { "post": { "operationId": "runs-sync-nice_dev-capterra-reviews-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/nice_dev~capterra-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-nice_dev-capterra-reviews-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrls": { "title": "Product or category URLs", "maxItems": 1000, "type": "array", "description": "Capterra product pages (`https://www.capterra.com/p/135003/Slack/`, `/reviews/` too, or capterra.com, .co.uk, .ca, .com.au, .in, .com.de: `https://www.capterra.co.uk/software/135003/slack`), Software Advice product pages (`https://www.softwareadvice.com/product/154669-slack/`) or GetApp product pages. A Capterra category (`https://www.capterra.com/directory/30021/crm/software`) adds its first **Max products per category** products. Max 1 000 URLs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "query": { "title": "Product name", "maxLength": 200, "type": "string", "description": "Software name as shown on Capterra (e.g. `Salesforce Sales Cloud`): the best match of the site's own search is used, and named in the log." }, "searchQueries": { "title": "More product names", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several products in one run, by name. Added to **Product name** and to the URLs; a product reached twice is read once.", "default": [], "items": { "type": "string" } }, "maxProductsPerCategory": { "title": "Max products per category", "minimum": 1, "maximum": 1000, "type": "integer", "description": "For category URLs: how many products of the category (in the site's order) are read. Each product then gets up to **Max reviews per product** reviews.", "default": 10 }, "maxItems": { "title": "Max reviews", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Maximum number of reviews to save for the whole run (after deduplication and filters). 0 = no limit.", "default": 100 }, "maxItemsPerQuery": { "title": "Max reviews per product", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Cap for EACH product, so that the first product cannot use up the whole **Max reviews** budget. 0 = all its reviews (beyond 10 000 the Actor splits the product by stars, company size and time used to reach the older ones; see Known limitations in the README).", "default": 0 }, "sortBy": { "title": "Sort reviews by", "enum": [ "most_recent", "most_helpful", "highest_rating", "lowest_rating" ], "type": "string", "description": "Order in which reviews are read (and saved).", "default": "most_recent" }, "includeReviewerDetails": { "title": "Reviewer job title, country and recommendation", "type": "boolean", "description": "Adds the reviewer's job title, country and 0-10 likelihood to recommend, read from Capterra UK review pages (about one more page per 25 recent reviews, more for older ones; same price). Off = faster, those 3 fields are null (always filled with Reviewer countries, which reads the Capterra UK pages). Needs the product's Capterra URL (a product name, a Software Advice or a GetApp URL leaves them null) and is not given with the **Most helpful** order.", "default": true }, "includeProductDetails": { "title": "Product details", "type": "boolean", "description": "Adds the product's overall rating, rating breakdown (1-5 stars), average sub-ratings, category, logo and top alternatives to every review of that product (one more page per product). Charged once per product (see Pricing).", "default": false }, "starRatings": { "title": "Star ratings", "uniqueItems": true, "type": "array", "description": "Only reviews with these overall ratings. Empty = all.", "items": { "type": "string", "enum": [ "5", "4", "3", "2", "1" ], "enumTitles": [ "5 stars", "4 stars", "3 stars", "2 stars", "1 star" ] }, "default": [] }, "companySizes": { "title": "Reviewer company size", "uniqueItems": true, "type": "array", "description": "Only reviews written by people from companies of these sizes. Empty = all (reviews without a company size included).", "items": { "type": "string", "enum": [ "A", "B", "C", "D", "E", "F", "G", "H", "I" ], "enumTitles": [ "Self-employed", "2-10 employees", "11-50 employees", "51-200 employees", "201-500 employees", "501-1,000 employees", "1,001-5,000 employees", "5,001-10,000 employees", "10,000+ employees" ] }, "default": [] }, "timeUsed": { "title": "Time the reviewer used the software", "uniqueItems": true, "type": "array", "description": "Only reviews from people who used the product for this long. Empty = all.", "items": { "type": "string", "enum": [ "FreeTrial", "LessThan6Months", "LessThan12Months", "LessThan2Years", "MoreThan2Years" ], "enumTitles": [ "Free trial", "Less than 6 months", "6-12 months", "1-2 years", "2+ years" ] }, "default": [] }, "reviewerCountries": { "title": "Reviewer countries", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Only reviews written from these countries: 2-letter codes (`gb`, `us`, `in`, `ca`, `fr`…). Filtered by Capterra UK, which does not give the reasons for choosing / switching, the vendor reply, the usage frequency or earlier versions: those fields are null when this filter is set. Needs the product's Capterra URL: a product given by name, Software Advice or GetApp URL is skipped with this filter. Empty = all countries.", "default": [], "items": { "type": "string" } }, "postedAfter": { "title": "Written after", "type": "string", "description": "Only reviews written on or after this date (`writtenOn`, the date of the latest version of an edited review): `2026-09-01`, or a period before now such as `7 days`, `2 weeks`, `1 month` (API: `24 hours` and full ISO date-times work too). With **Most recent** order, reading stops at the first older review." }, "postedBefore": { "title": "Written before", "type": "string", "description": "Only reviews written on or before this date (the whole day is included), or older than a period such as `30 days`." }, "keywords": { "title": "Keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Keep only the reviews whose title, pros, cons or comments contain at least one of these words (whole words; case and accents ignored).", "default": [], "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Drop the reviews whose title, pros, cons or comments contain one of these words (case and accents ignored).", "default": [], "items": { "type": "string" } }, "reviewerIndustries": { "title": "Reviewer industries", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Keep only the reviews whose reviewer industry contains one of these words, as whole words (e.g. `Hospital`, `Retail`, `Computer Software`: `Hospital` does not keep `Hospitality`). Case ignored. Reviews without an industry are dropped.", "default": [], "items": { "type": "string" } }, "verifiedOnly": { "title": "Verified reviewers only", "type": "boolean", "description": "Keep only reviews whose reviewer was validated by the site (`reviewer.isValidated`). With Reviewer countries, Capterra UK shows the mark on some validated reviewers only: the others are dropped.", "default": false }, "excludeIncentivized": { "title": "Exclude incentivized reviews", "type": "boolean", "description": "Drop the reviews written in exchange for a gift or invited with an incentive (`incentivized` other than `NoIncentive`).", "default": false }, "withResponseOnly": { "title": "Only reviews with a vendor reply", "type": "boolean", "description": "Keep only the reviews the software vendor answered. Not with Reviewer countries: the pages of a country do not show the vendor reply.", "default": false }, "onlyNew": { "title": "Only new reviews", "type": "boolean", "description": "Skip the reviews that a previous run (same **Memory key**) already delivered: they are not saved and not charged. With **Most recent** order, reading of a product stops at its first known review. First run = everything is new.", "default": false }, "stateKey": { "title": "Memory key", "pattern": "^[a-zA-Z0-9_-]{1,64}$", "maxLength": 64, "type": "string", "description": "Name of the memory used by **Only new reviews**. Give each schedule / task its own key (e.g. `crm-watch`) so that they do not share their memory. Letters, digits, `-` and `_`.", "default": "default" }, "resetState": { "title": "Reset the memory", "type": "boolean", "description": "Forget everything remembered under this **Memory key** before the run: this run returns (and charges) every review again. Untick it afterwards.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or your own proxies. Keep the default: it is included in the price. The residential Apify proxy is not available in this Actor.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of requests processed in parallel.", "default": 4 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 10, "maximum": 2000, "type": "integer", "description": "Most requests to the sites in any 60 seconds, all of them counted (review pages, product pages, searches). Lower it if the log shows HTTP 429 / 403.", "default": 120 }, "minRequestIntervalMs": { "title": "Min delay between requests", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Smallest gap between two requests, in milliseconds. 0 = no gap.", "default": 0 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "Retries per request before it is marked as failed. Behind a proxy, a request the site turns away is also retried on a new proxy session up to 10 times without using up these retries.", "default": 5 }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Include debug messages in the run log.", "default": false }, "productUrl": { "title": "productUrl (alias of startUrls)", "type": "string", "description": "Accepted for compatibility: one product URL." }, "productName": { "title": "productName (alias of query)", "type": "string", "description": "Accepted for compatibility: one product name." }, "maxResults": { "title": "maxResults (alias of maxItems)", "type": "integer", "description": "Accepted for compatibility." }, "maxReviews": { "title": "maxReviews (alias of maxItems)", "type": "integer", "description": "Accepted for compatibility." }, "maxReviewsPerProduct": { "title": "maxReviewsPerProduct (alias of maxItemsPerQuery)", "type": "integer", "description": "Accepted for compatibility." }, "maxReviewsPerProfile": { "title": "maxReviewsPerProfile (alias of maxItemsPerQuery)", "type": "integer", "description": "Accepted for compatibility." }, "sort": { "title": "sort (alias of sortBy)", "type": "string", "description": "Accepted for compatibility: also MOST_RECENT, HIGHEST_COMPLETENESS_SCORE, HIGHEST_RATED, LOWEST_RATED." }, "sortOrder": { "title": "sortOrder (alias of sortBy)", "type": "string", "description": "Accepted for compatibility." }, "minRating": { "title": "minRating (lowest star kept)", "type": "integer", "description": "Accepted for compatibility: turned into Star ratings." }, "maxRating": { "title": "maxRating (highest star kept)", "type": "integer", "description": "Accepted for compatibility: turned into Star ratings." }, "publishedAfter": { "title": "publishedAfter (alias of postedAfter)", "type": "string", "description": "Accepted for compatibility." }, "reviewedAfter": { "title": "reviewedAfter (alias of postedAfter)", "type": "string", "description": "Accepted for compatibility." }, "fromDate": { "title": "fromDate (alias of postedAfter)", "type": "string", "description": "Accepted for compatibility." }, "publishedBefore": { "title": "publishedBefore (alias of postedBefore)", "type": "string", "description": "Accepted for compatibility." }, "toDate": { "title": "toDate (alias of postedBefore)", "type": "string", "description": "Accepted for compatibility." }, "onlyVerified": { "title": "onlyVerified (alias of verifiedOnly)", "type": "boolean", "description": "Accepted for compatibility." }, "incremental": { "title": "incremental (alias of onlyNew)", "type": "boolean", "description": "Accepted for compatibility." }, "monitorKey": { "title": "monitorKey (alias of stateKey)", "type": "string", "description": "Accepted for compatibility." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }