{ "openapi": "3.0.1", "info": { "title": "CareerBliss Company Reviews & Salaries Scraper", "description": "Scrape CareerBliss.com - employee company reviews, star ratings across 8 workplace categories, real salary data by job title, and a directory of featured employers. No login, no cookies, no API key required.", "version": "1.0", "x-build-id": "CBRm1M1hAxLeTowAT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~careerbliss-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-careerbliss-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/crawlerbros~careerbliss-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-careerbliss-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/crawlerbros~careerbliss-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-careerbliss-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "reviews", "salaries", "companyOverview", "browseCompanies", "jobTitleOverview", "jobTitleReviews", "browseJobTitles", "happiestCompanies", "jobListings", "search", "topCompaniesByIndustry" ], "type": "string", "description": "What to scrape.", "default": "reviews" }, "companySlugs": { "title": "Company slugs or URLs (mode=reviews/salaries/companyOverview)", "type": "array", "description": "CareerBliss company identifiers — either the URL slug (e.g. `google`, `amazon`, `microsoft`) or a full company page URL (e.g. `https://www.careerbliss.com/google/`). Find slugs by browsing careerbliss.com or using mode=browseCompanies.", "default": [ "google" ], "items": { "type": "string" } }, "browseCompaniesLetter": { "title": "Browse companies by starting letter (mode=browseCompanies)", "enum": [ "", "a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z", "1" ], "type": "string", "description": "Optional: scrape the FULL alphabetical company directory for a single starting letter (e.g. `a`, `t`) or `1` for companies starting with a digit — this can return thousands of companies (paginated, capped by Max items) instead of the ~40-company featured list on the browse-companies homepage. Leave empty to scrape the small featured directory instead.", "default": "" }, "industry": { "title": "Industry (mode=topCompaniesByIndustry)", "enum": [ "accommodation", "accounting-and-payrol-services", "advertising-and-pr", "air-transportation", "ambulatory-health-care-services", "amusement-and-gambling", "apparel-manufacturing", "appliance-and-component-manufacturing", "architecture-and-engineering", "automotive-repair", "beverage-and-tobacco-products", "broadcasting", "building-construction", "building-materials-and-garden-equipment", "building-services", "business-schools", "business-support-services", "chemical-manufacturing", "clothing-and-apparel-stores", "colleges-and-universities", "computer-and-electronic-manufacturing", "computer-systems-design", "couriers-and-messengers", "credit-intermediation-activities", "data-services", "dining-and-food-services", "educational-support-services", "electric-power-generation", "electronics-and-appliance-stores", "elementary-and-secondary-schools", "employment-services", "engineering-and-construction", "facilities-support-services", "farming-and-natural-resources", "financial-investments", "food-and-beverage-stores", "food-manufacturing", "funds-and-trusts", "furniture-and-home-furnishings", "furniture-manufacturing", "gasoline-stations", "general-merchandise-stores", "health-and-personal-care-stores", "hospitals-and-health-centers", "information-services", "insurance-carriers", "investigation-and-security-services", "junior-colleges", "laundry-services", "legal-services", "lessors-of-nonfinancial-intangible-assets", "machinery-manufacturing", "maintenance-repair", "management-of-companies-and-enterprises", "medical-equipment-and-supplies", "metal-product-manufacturing", "mineral-product-manufacturing", "mining-oil-and-gas-extraction", "miscellaneous-manufacturing", "motion-picture", "motor-vehicle-and-parts-dealers", "natural-gas-distribution", "nonstore-retailers", "nursing-and-residential-care", "office-administrative-services", "paper-manufacturing", "petroleum-and-coal-products", "pipeline-transportation", "plastic-and-rubber-manufacturing", "primary-metal-manufacturing", "printing-and-publishing", "professional-services", "public-administration", "publishing-industries", "rail-transportation", "real-estate", "rental-and-leasing-services", "retailers", "scenic-transportation", "schools-and-instruction", "scientific-and-technical-consulting-services", "scientific-rd-services", "services", "social-assistance", "specialized-design-services", "specialty-trade", "sports-and-performing-arts", "support-services", "technical-and-trade-schools", "telecommunications", "textile-mills", "transit-transportation", "transportation-equipment-manufacturing", "transportation-support", "travel-reservation-services", "truck-transportation", "warehousing-and-storage", "waste-management", "water-and-sewage", "water-transportation", "wholesale-trade", "wood-product-manufacturing" ], "type": "string", "description": "CareerBliss industry category to fetch the top-rated hiring companies for (typically ~20 companies per industry, ranked by employee rating). Each result includes the company slug, which can be fed into companySlugs for reviews/salaries/companyOverview." }, "jobTitleSlugs": { "title": "Job title slugs or URLs (mode=jobTitleOverview/jobTitleReviews/jobListings)", "type": "array", "description": "CareerBliss job-title identifiers — either the URL slug (e.g. `software-engineer`, `accountant`, `registered-nurse`) or a full job-title page URL (e.g. `https://www.careerbliss.com/software-engineer/`). Find slugs by using mode=browseJobTitles. With mode=jobTitleOverview, returns the national average salary, open job count, average review rating, and top-paying companies for that title across all of CareerBliss. With mode=jobTitleReviews, returns individual employee reviews for that title written at many different companies nationwide (not scoped to one company). With mode=jobListings, returns actual open job postings for that title nationwide.", "default": [ "software-engineer" ], "items": { "type": "string" } }, "searchQuery": { "title": "Search keyword (mode=search)", "type": "string", "description": "Free-text keyword to search CareerBliss for — a job title, company name, or skill (e.g. `nurse`, `google`, `software engineer`). Required for mode=search, EXCEPT when searchType=job and searchLocation is set — in that case you can leave this empty to browse ALL open postings in that location instead of filtering by keyword. Uses CareerBliss's own site-wide search, so no company or job-title slug needs to be known in advance." }, "searchType": { "title": "Search result type (mode=search)", "enum": [ "job", "company", "review", "salary", "resource" ], "type": "string", "description": "What kind of result to return for the search keyword.", "default": "job" }, "searchLocation": { "title": "Search location (mode=search, searchType=job)", "type": "string", "description": "Optional: narrow job-posting search results to a city/state, e.g. `Austin, TX` or `New York`. Only applies when searchType=job. If searchQuery is left empty, setting this alone browses ALL open job postings in that location (no keyword needed)." }, "reviewsSortOrder": { "title": "Reviews sort order (mode=reviews)", "enum": [ "date", "date_asc", "rate", "rate_asc" ], "type": "string", "description": "Order to fetch employee reviews in. Newest first is the CareerBliss default. Note: CareerBliss only renders the per-review star rating in its \"Oldest first\" and \"Lowest rating first\" page markup for a handful of reviews per page (unlike \"Newest first\"/\"Highest rating first\", which carry it on every card) — `overallRating` is simply omitted (never faked) on cards where it isn't served, and `minRating`/`maxRating` cannot filter out a review whose rating CareerBliss didn't expose.", "default": "date" }, "minRating": { "title": "Min overall rating (mode=reviews/jobTitleReviews)", "minimum": 1, "maximum": 5, "type": "integer", "description": "Drop reviews with an overall star rating below this value (1-5)." }, "maxRating": { "title": "Max overall rating (mode=reviews/jobTitleReviews)", "minimum": 1, "maximum": 5, "type": "integer", "description": "Drop reviews with an overall star rating above this value (1-5)." }, "minSalary": { "title": "Min annual salary USD (mode=salaries)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop salary records below this annual USD amount." }, "maxSalary": { "title": "Max annual salary USD (mode=salaries)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop salary records above this annual USD amount." }, "jobTitleContains": { "title": "Job title contains (mode=reviews/salaries/jobListings/search)", "type": "string", "description": "Keep only records whose job title contains this text (case-insensitive). For mode=search, applies to searchType=job/review results." }, "locationContains": { "title": "Location contains (mode=reviews/salaries/jobListings/jobTitleReviews/search)", "type": "string", "description": "Keep only records whose location contains this text (case-insensitive), e.g. `CA` or `New York`. For mode=search, applies to searchType=job/review results." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on emitted records across all requested companies.", "default": 50 } } }, "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 } } } } } } } } } }