{ "openapi": "3.0.1", "info": { "title": "Indeed Company API | Ratings, Reviews, Salaries Data", "description": "Indeed company profiles as clean, structured JSON. Look up employers by name, browse by industry and state, crawl a company directory, or fetch exact company URLs. Get overall rating, review and salary counts, work happiness, size, revenue, headquarters, benefits, and open-job counts. MCP-ready.", "version": "0.0", "x-build-id": "axyg9m9aUEHpYNVdZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~indeed-company-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-indeed-company-api", "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/johnvc~indeed-company-api/runs": { "post": { "operationId": "runs-sync-johnvc-indeed-company-api", "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/johnvc~indeed-company-api/run-sync": { "post": { "operationId": "run-sync-johnvc-indeed-company-api", "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": [ "keyword", "url", "industry", "directory" ], "type": "string", "description": "Keyword looks companies up by name and needs no URL. URL collects exact company pages you already hold. Industry browses every company in one industry across the states you list. Directory crawls an Indeed browse-companies page.", "default": "keyword" }, "country": { "title": "Country", "enum": [ "US", "AE", "AR", "AT", "AU", "BE", "BH", "BR", "CA", "CH", "CL", "CO", "CR", "CZ", "DE", "DK", "EC", "EG", "ES", "FI", "FR", "GB", "GR", "HK", "HU", "ID", "IE", "IL", "IN", "IT", "JP", "KR", "KW", "LU", "MX", "MY", "NG", "NL", "NO", "NZ", "OM", "PA", "PE", "PH", "PK", "PL", "PT", "QA", "RO", "SA", "SE", "SG", "TH", "TR", "TW", "UA", "UY", "VE", "VN", "ZA" ], "type": "string", "description": "Which Indeed country site to read. URL and keyword modes work across countries; industry and directory browse are United States only, so pick United States for those. A company URL you paste always wins over this setting.", "default": "US" }, "keywords": { "title": "Company names", "maxItems": 10, "type": "array", "description": "Company names to look up, for example \"Tesla\" or \"Allstate\". Each name is searched separately and the searches run in parallel, so several names cost little more time than one. A name can match more than one employer. Used in keyword mode. Up to 10 per run. Need larger batches? Contact us and we can raise this limit for your account.", "items": { "type": "string" } }, "companyUrls": { "title": "Company URLs", "maxItems": 100, "type": "array", "description": "Indeed company references, one company each. Accepts a full profile URL (https://www.indeed.com/cmp/Allstate-Insurance), a sub-page URL (https://www.indeed.com/cmp/Allstate-Insurance/reviews), or a bare slug (Allstate-Insurance). Used in URL mode. Up to 100 per run. Need larger batches? Contact us and we can raise this limit for your account.", "items": { "type": "string" } }, "industry": { "title": "Industry", "enum": [ "All", "Accounting & Tax", "Advertising & Public Relations", "Aerospace & Defense", "Agriculture", "Airlines, Airports & Air Transportation", "Ambulance & Medical Transportation", "Animal Production", "Architectural & Engineering Services", "Arts, Entertainment & Recreation", "Auctions & Galleries", "Automotive Parts & Accessories Stores", "Banking & Lending", "Bars & Nightclubs", "Beauty & Personal Accessories Stores", "Beauty & Wellness", "Biotechnology", "Broadcast Media", "Business Consulting", "Car & Truck Rental", "Catering & Food Service Contractors", "Chemical Manufacturing", "Civic & Social Services", "Colleges & Universities", "Commercial Equipment Services", "Commercial Printing", "Computer Hardware Development", "Construction", "Construction, Repair & Maintenance Services", "Consumer Electronics & Appliances Stores", "Consumer Product Manufacturing", "Convenience Stores", "Crop Production", "Culture & Entertainment", "Debt Relief", "Dental Clinics", "Department, Clothing & Shoe Stores", "Drug & Health Stores", "Education", "Education & Training Services", "Electronics Manufacturing", "Energy & Utilities", "Energy, Mining & Utilities", "Event Services", "Farm Support", "Film Production", "Financial Services", "Financial Transaction Processing", "Fishery", "Floral Nursery", "Food & Beverage Manufacturing", "Food & Beverage Stores", "Forestry, Logging & Timber Operations", "Gambling", "General Merchandise & Superstores", "General Repair & Maintenance", "Gift, Novelty & Souvenir Stores", "Government & Public Administration", "Grantmaking & Charitable Foundations", "Grocery Stores", "Health Care Products Manufacturing", "Healthcare", "Home Furniture & Housewares Stores", "Hospitals & Health Clinics", "Hotels & Resorts", "Hotels & Travel Accommodation", "HR Consulting", "Human Resources & Staffing", "Information Technology", "Information Technology Support Services", "Insurance", "Insurance Agencies & Brokerages", "Insurance Carriers", "Internet & Web Services", "Investment & Asset Management", "Laundry & Dry Cleaning", "Law Firms", "Legal", "Legal Services", "Machinery Manufacturing", "Management & Consulting", "Manufacturing", "Marine Transportation", "Media & Communication", "Media & Entertainment Stores", "Medical Testing & Clinical Laboratories", "Membership Organizations", "Metal & Mineral Manufacturing", "Mining & Metals", "Municipal Agencies", "Music & Sound Production", "National Agencies", "Nonprofit & NGO", "Nursing Care", "Office Supply & Copy Stores", "Parking & Valet", "Personal Consumer Services", "Pet & Pet Supplies Stores", "Pet Care & Veterinary", "Pharmaceutical", "Pharmaceutical & Biotechnology", "Photography", "Preschools & Child Care Services", "Primary & Secondary Schools", "Private Households", "Property Management", "Publishing", "Rail Transportation", "Real Estate", "Real Estate Agencies", "Recruiting", "Recruiting & Staffing", "Religious Institutions", "Research & Development", "Restaurants & Cafes", "Restaurants & Food Service", "Retail & Wholesale", "Security & Protective", "Shipping & Trucking", "Software Development", "Sporting Goods Stores", "Sports & Recreation", "Staffing", "State & Regional Agencies", "Stock Exchanges", "Taxi & Car Services", "Telecommunications", "Textile & Apparel Manufacturing", "Ticket Sales", "Toy & Hobby Stores", "Translation & Linguistic Services", "Transportation & Logistics", "Transportation Equipment Manufacturing", "Transportation Management", "Travel Agencies", "Vehicle Dealers", "Vehicle Repair & Maintenance", "Video Game Publishing", "Waste Management", "Wholesale", "Wood & Paper Manufacturing" ], "type": "string", "description": "Which industry to browse, using the source's own industry list. The source matches these exactly and rejects anything else, so pick from the list rather than typing your own. Leave as All to browse every industry. Used in industry mode.", "default": "All" }, "states": { "title": "States or areas", "maxItems": 10, "type": "array", "description": "Where to browse, one search per entry. Accepts a US state name (\"California\"), the whole country (\"United States\"), or a metro area (\"Sacramento, CA\"). Each entry is combined with the industry above, so three states means three searches, and they run in parallel. Used in industry mode. Up to 10 per run. Need larger batches? Contact us and we can raise this limit for your account.", "items": { "type": "string" } }, "directoryUrls": { "title": "Directory URLs", "maxItems": 10, "type": "array", "description": "Indeed browse-companies pages, for example https://www.indeed.com/companies/browse-companies. Every company found on each page is returned, up to the result limit below. Used in directory mode. Up to 10 per run. Need larger batches? Contact us and we can raise this limit for your account.", "items": { "type": "string" } }, "maxResultsPerInput": { "title": "Max companies per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many companies to return for each name, state, or directory page. You are charged per company returned, so this is also your cost control. The limit is applied as results are collected, so nothing beyond it is collected or billed. Ignored in URL mode, where each URL returns one company. A run that returns no companies is never charged.", "default": 25 }, "profileDetail": { "title": "Profile detail", "enum": [ "full", "listing" ], "type": "string", "description": "How much to return for companies found by keyword, industry, or directory. Full fetches each company page for the complete profile. Listing returns the lighter card straight from the results, which is cheaper and faster. URL mode is always a full profile.", "default": "full" }, "resolveExact": { "title": "Resolve to one company (keyword mode)", "type": "boolean", "description": "In keyword mode, return only the single best-matching company for each name instead of every candidate. If nothing matches closely, an uncharged error row names the closest companies found.", "default": false }, "uniqueCompaniesOnly": { "title": "Unique companies only", "type": "boolean", "description": "Drop duplicate companies within a run, so the same employer is never returned or charged twice across your inputs.", "default": true }, "includeReviews": { "title": "Include employee reviews", "type": "boolean", "description": "Also return employee reviews for each company as separate rows (result_type 'review'), each charged per review returned. Full profile only.", "default": false }, "maxReviewsPerCompany": { "title": "Max reviews per company", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many reviews to return for each company when reviews are included. Reviews are read 20 per page, newest available first.", "default": 20 }, "reviewsSince": { "title": "Only reviews since (YYYY-MM-DD)", "type": "string", "description": "Optional. Only return reviews submitted on or after this date, for example 2026-01-01. Leave blank for no date limit." }, "reviewsAllCountries": { "title": "Reviews from all countries", "type": "boolean", "description": "Include reviews written on every Indeed country site, not only the site being read. Widens the review pool for large multinational employers.", "default": false }, "includeSalaries": { "title": "Include salaries", "type": "boolean", "description": "Also return reported salaries by job title for each company as separate rows (result_type 'salary'), each charged per salary row returned. Full profile only.", "default": false }, "includeQuestions": { "title": "Include questions (Q&A)", "type": "boolean", "description": "Also return questions from each company's Q&A section as separate rows (result_type 'question'), each charged per question returned. Full profile only.", "default": false }, "maxQuestionsPerCompany": { "title": "Max questions per company", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many questions to return for each company when questions are included. Questions are read 10 per page.", "default": 10 } } }, "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 } } } } } } } } } }