{ "openapi": "3.0.1", "info": { "title": "Indeed Company Reviews Scraper + Insights", "description": "Scrape Indeed company reviews and get a computed summary in the same run: rating distribution, current-vs-former employee gap, per-job-title and per-location breakdowns, monthly trend, and top complaint terms. No AI keys required.", "version": "0.1", "x-build-id": "b0FghYaSKzbAl3JHQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/a7_data~indeed-company-reviews-insights/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-a7_data-indeed-company-reviews-insights", "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/a7_data~indeed-company-reviews-insights/runs": { "post": { "operationId": "runs-sync-a7_data-indeed-company-reviews-insights", "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/a7_data~indeed-company-reviews-insights/run-sync": { "post": { "operationId": "run-sync-a7_data-indeed-company-reviews-insights", "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", "required": [ "companies" ], "properties": { "companies": { "title": "Companies", "maxItems": 200, "type": "array", "description": "Company names or Indeed company review URLs. A name like `Google` is turned into `https://www.indeed.com/cmp/Google/reviews`. Names with spaces become hyphenated, e.g. `Home Depot` → `Home-Depot`. 1回の実行で最大200社まで。", "default": [ "Google" ], "items": { "type": "string" } }, "maxReviewsPerCompany": { "title": "Max reviews per company", "minimum": 20, "maximum": 2000, "type": "integer", "description": "How many individual reviews to collect per company. Indeed returns 20 per page, and each page takes 20-30 seconds. The company-level summary (rating distribution, category ratings, topic breakdown for ALL of the company's reviews) comes from the first page, so the default of 20 already gives you the full overview. Raise it when you want the review text itself or bigger per-job-title and per-location samples.", "default": 20 }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code to filter reviews by, e.g. `US`, `GB`, `IN`. Leave as `US` for the default Indeed domain.", "default": "US" }, "includeReviews": { "title": "Output individual reviews", "type": "boolean", "description": "Push one dataset item per review. Turn this off if you only want the per-company summary.", "default": true }, "includeInsights": { "title": "Output company insights", "type": "boolean", "description": "Push one dataset item per company containing the computed summary: rating distribution, current-vs-former employee gap, per-job-title and per-location breakdowns, monthly trend, and the most common terms in low-rated reviews. Computed with plain arithmetic — no AI credits or API keys needed.", "default": true }, "filterTopic": { "title": "Filter by topic", "enum": [ "wlbalance", "paybenefits", "jobsecadv", "mgmt", "culture" ], "type": "string", "description": "Restrict reviews to one Indeed topic." }, "filterJobTitle": { "title": "Filter by job title", "type": "string", "description": "Restrict reviews to one job title, e.g. `Software Engineer`." }, "filterLocation": { "title": "Filter by location", "type": "string", "description": "Restrict reviews to one location, e.g. `New York, NY`." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many pages to fetch at once. Keep this low — Indeed pages are fetched through an unblocking proxy and higher concurrency makes failures more likely, not the run faster.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Indeed blocks plain requests. This Actor defaults to Apify's Unblocker, which is what makes the pages reachable. Changing this is only useful if you know your own proxy gets through.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } } } }, "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 } } } } } } } } } }