{ "openapi": "3.0.1", "info": { "title": "SoftwareAdvice Reviews Scraper", "description": "[💰 $3.0 / 1K] Extract software products and user reviews from SoftwareAdvice: product name, vendor, category, rating, plus full reviews (rating, pros, cons, role, industry, date) as separate rows. Find products by company domain, search term, or URL. Great for product and competitor research.", "version": "1.0", "x-build-id": "4CH6Sn8yxRf4ew2fQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~softwareadvice-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-softwareadvice-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/solidcode~softwareadvice-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-softwareadvice-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/solidcode~softwareadvice-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-softwareadvice-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": "SoftwareAdvice URLs", "type": "array", "description": "Paste one or more SoftwareAdvice URLs — product pages, product review pages, or category/search result pages. This is the most precise way to scrape exactly the products you want. Leave blank to use the domain or search options below.", "items": { "type": "string" } }, "domains": { "title": "Company Domains", "type": "array", "description": "Company website domains, for example postman.com or salesforce.com. Each domain is matched to its SoftwareAdvice product page automatically — no manual lookup needed.", "items": { "type": "string" } }, "searchQueries": { "title": "Search Terms", "type": "array", "description": "Free-text product or category searches, for example 'CRM', 'project management', or 'Slack'. Each term returns the matching products from SoftwareAdvice.", "items": { "type": "string" } }, "maxResults": { "title": "Max Products", "minimum": 0, "type": "integer", "description": "Cap on the total number of products collected across all URLs, domains, and search terms. Default 100. Set to 0 for no cap. The actor stops processing new products once the cap is reached.", "default": 100 }, "includeReviews": { "title": "Include Reviews", "type": "boolean", "description": "Collect each product's user reviews (rating, pros, cons, reviewer details, date). Turn off for faster, cheaper runs that return only product and vendor details with no reviews.", "default": true }, "maxReviewsPerProduct": { "title": "Max Reviews Per Product", "minimum": 0, "type": "integer", "description": "Cap on the number of reviews captured per product (most recent first). Default 0 = all reviews, up to a safety ceiling of 5,000 per product. A few very popular products (e.g. Salesforce) have more than 5,000 reviews; collection stops at 5,000 for those and the run log notes it. Set a positive number to limit how many you collect per product and cap your cost. Each review is returned as its own result. Ignored when 'Include Reviews' is off.", "default": 0 }, "reviewsStartDate": { "title": "Reviews From Date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only collect reviews published on or after this date. Use the format YYYY-MM-DD, for example 2024-01-15. Leave blank to collect all reviews regardless of date." } } }, "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 } } }, "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 } } } } } } } } } }