{ "openapi": "3.0.1", "info": { "title": "AmbitionBox Company Reviews Scraper", "description": "Extract reviews for any company listed on AmbitionBox.com — ratings, pros, cons, job titles, and more. Get structured JSON output via API, MCP, or Console.", "version": "0.1", "x-build-id": "uj1K2Yf43enPhLIJH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hgservices~ambitionbox-company-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hgservices-ambitionbox-company-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/hgservices~ambitionbox-company-reviews-scraper/runs": { "post": { "operationId": "runs-sync-hgservices-ambitionbox-company-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/hgservices~ambitionbox-company-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-hgservices-ambitionbox-company-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": "Start URLs", "type": "array", "description": "Direct AmbitionBox review URLs to scrape (e.g. https://www.ambitionbox.com/reviews/tcs-reviews). The Actor detects the company from the URL automatically.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "companySlugs": { "title": "Popular Companies", "type": "array", "description": "Select from a curated list of ~175 well-known companies. The Actor builds the review URLs automatically.", "items": { "type": "string", "enum": [ "abb", "accenture", "adani-enterprises", "adani-group", "aditya-birla-finance", "aditya-birla-group", "adobe", "amazon", "american-express", "amul-india", "apple", "asian-paints", "atlassian", "atos", "axis-bank", "bain-and-company", "bajaj-finance", "bajaj-finserv", "barclays", "bcg", "bharatpe", "bharti-airtel", "bigbasket", "biocon", "birlasoft", "blinkit", "bmw", "boat", "bosch", "britannia", "byjus", "capgemini", "cars24-dot-com", "cipla", "cisco", "citibank", "cleartrip", "coca-cola-company", "coforge", "cognizant", "colgate-palmolive", "cred", "cyient", "dabur", "dell", "deloitte", "deutsche-bank", "divis-laboratories", "dr-reddys-foundation", "dream11", "dunzo", "ernst-young", "facebook", "flipkart", "fractal-analytics", "freshworks", "genpact", "godrej-consumer-products", "godrej-industries", "godrej-infotech", "godrej-properties", "goldman-sachs", "google", "groww", "hcl-technologies", "hdfc-bank", "hexaware-technologies", "hindustan-unilever", "honda", "hsbc", "hyundai-motor", "ibm", "icici-bank", "idfc-first-bank", "indiamart-intermesh", "infosys", "infosys-bpm", "intel", "itc", "jio", "johnson-and-johnson", "jp-morgan-chase", "kia-motors", "kotak-mahindra-bank", "kpmg", "l-and-t", "larsen-and-toubro-limited", "latentview-analytics", "lenovo", "lenskart", "lg-electronics", "loreal", "ltimindtree", "lupin", "mahindra-and-mahindra", "makemytrip", "mamaearth", "marico-limited", "maruti-suzuki", "mckinsey-and-company", "meesho", "meta", "microsoft-corporation", "mindtree", "morgan-stanley", "mphasis", "mu-sigma", "myntra", "naukri", "nestle", "noise", "ntt-data", "nutanix", "nvidia", "nykaa-e-retail", "ola-cabs", "ola-electric-mobility", "oracle", "oyo-rooms", "parle-agro", "parle-products", "paytm", "pepsico", "persistent-systems", "phonepe", "policybazaar", "procter-and-gamble", "pwc", "qualcomm", "rapido", "razorpay", "reliance-industries", "reliance-jio", "salesforce", "samsung", "sap", "sbi-cards-and-payment-services", "sbi-life-insurance-company", "schneider-electric", "servicenow", "siemens-india", "snapdeal", "sony", "spinny", "sun-pharmaceutical-industries", "swiggy", "tata-communications", "tata-elxsi", "tata-motors", "tata-power", "tata-steel", "tata-technologies", "tcs", "tech-mahindra", "tesla", "tiger-analytics", "titan-company", "toyota", "uber", "ultratech-cement", "unacademy", "upgrad", "upstox", "urban-company", "vedantu", "vmware-software", "vodafone-idea", "volkswagen", "wipro", "yes-bank", "zensar-technologies", "zepto", "zerodha", "zoho", "zomato", "zydus-cadila" ], "enumTitles": [ "ABB", "Accenture", "Adani Enterprises", "Adani Group", "Aditya Birla Finance", "Aditya Birla Group", "Adobe", "Amazon", "American Express", "Amul India", "Apple", "Asian Paints", "Atlassian", "Atos", "Axis Bank", "Bain And Company", "Bajaj Finance", "Bajaj Finserv", "Barclays", "BCG", "Bharatpe", "Bharti Airtel", "Bigbasket", "Biocon", "Birlasoft", "Blinkit", "BMW", "Boat", "Bosch", "Britannia", "BYJU'S", "Capgemini", "Cars24 .com", "Cipla", "Cisco", "Citibank", "Cleartrip", "Coca Cola Company", "Coforge", "Cognizant", "Colgate Palmolive", "Cred", "Cyient", "Dabur", "Dell", "Deloitte", "Deutsche Bank", "Divis Laboratories", "Dr Reddys Foundation", "Dream11", "Dunzo", "Ernst Young", "Facebook", "Flipkart", "Fractal Analytics", "Freshworks", "Genpact", "Godrej Consumer Products", "Godrej Industries", "Godrej Infotech", "Godrej Properties", "Goldman Sachs", "Google", "Groww", "HCL Technologies", "HDFC Bank", "Hexaware Technologies", "Hindustan Unilever", "Honda", "HSBC", "Hyundai Motor", "IBM", "ICICI Bank", "IDFC First Bank", "Indiamart Intermesh", "Infosys", "Infosys Bpm", "Intel", "ITC", "Jio", "Johnson And Johnson", "JP Morgan Chase", "Kia Motors", "Kotak Mahindra Bank", "KPMG", "L And T", "Larsen And Toubro Limited", "Latentview Analytics", "Lenovo", "Lenskart", "LG Electronics", "Loreal", "Ltimindtree", "Lupin", "Mahindra And Mahindra", "Makemytrip", "Mamaearth", "Marico Limited", "Maruti Suzuki", "Mckinsey And Company", "Meesho", "Meta", "Microsoft Corporation", "Mindtree", "Morgan Stanley", "Mphasis", "Mu Sigma", "Myntra", "Naukri", "Nestle", "Noise", "NTT Data", "Nutanix", "NVIDIA", "Nykaa E Retail", "Ola Cabs", "Ola Electric Mobility", "Oracle", "OYO Rooms", "Parle Agro", "Parle Products", "Paytm", "Pepsico", "Persistent Systems", "Phonepe", "Policybazaar", "Procter And Gamble", "PwC", "Qualcomm", "Rapido", "Razorpay", "Reliance Industries", "Reliance Jio", "Salesforce", "Samsung", "SAP", "SBI Cards And Payment Services", "SBI Life Insurance Company", "Schneider Electric", "Servicenow", "Siemens India", "Snapdeal", "Sony", "Spinny", "Sun Pharmaceutical Industries", "Swiggy", "Tata Communications", "Tata Elxsi", "Tata Motors", "Tata Power", "Tata Steel", "Tata Technologies", "TCS", "Tech Mahindra", "Tesla", "Tiger Analytics", "Titan Company", "Toyota", "Uber", "Ultratech Cement", "Unacademy", "Upgrad", "Upstox", "Urban Company", "Vedantu", "Vmware Software", "Vodafone Idea", "Volkswagen", "Wipro", "Yes Bank", "Zensar Technologies", "Zepto", "Zerodha", "Zoho", "Zomato", "Zydus Cadila" ] } }, "customSlugs": { "title": "Custom Company Slugs", "type": "array", "description": "Type any company slug not in the Popular Companies list. The slug is the URL path segment, e.g. for ambitionbox.com/reviews/tcs-reviews the slug is \"tcs\".", "items": { "type": "string" } }, "maxItems": { "title": "Maximum Reviews per Company", "minimum": 20, "type": "integer", "description": "Maximum number of reviews to scrape per company. One page returns approximately 20 reviews.", "default": 100 } } }, "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 } } } } } } } } } }