{ "openapi": "3.0.1", "info": { "title": "Indeed Global Job Scraper with Company Salary Reports", "description": "Search Indeed jobs across 62 countries by keyword, location, or filters for job type, remote status, experience, education, and salary. Returns full descriptions, structured salaries, and each employer's ratings and salary-by-title reports.", "version": "1.0", "x-build-id": "lqQyrji8BaXSFlXeb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nimbryxo-studio~indeed-global-job-scraper-with-company-salary/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nimbryxo-studio-indeed-global-job-scraper-with-company-salary", "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/nimbryxo-studio~indeed-global-job-scraper-with-company-salary/runs": { "post": { "operationId": "runs-sync-nimbryxo-studio-indeed-global-job-scraper-with-company-salary", "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/nimbryxo-studio~indeed-global-job-scraper-with-company-salary/run-sync": { "post": { "operationId": "run-sync-nimbryxo-studio-indeed-global-job-scraper-with-company-salary", "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": { "position": { "title": "Position or keywords", "type": "string", "description": "Job title, skill or keywords, e.g. `web developer`, `nurse`. Search one company's jobs with `company:Amazon`, titles only with `title:(data analyst)`; quotes, OR and -exclusions work too." }, "location": { "title": "Location", "type": "string", "description": "City, region or postal code, e.g. `San Francisco`, `Austin, TX`, `10001`, `London`. Leave empty to search the whole country." }, "company": { "title": "Company", "type": "string", "description": "Only jobs from one employer, e.g. `Amazon`, `Visa`, `DocuSign`. The name is resolved to Indeed's employer key so the company filter is applied by Indeed itself, then verified per job." }, "locationShards": { "title": "City or region shards", "type": "array", "description": "Optional list of extra locations to search separately with the same keywords and filters, e.g. `New York, NY`, `Chicago, IL`, `Remote`. Deduplication removes jobs found by more than one shard. This is the reliable way past the roughly 1,000-row cursor ceiling.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "US", "AR", "AU", "AT", "BH", "BE", "BR", "CA", "CL", "CN", "CO", "CR", "CZ", "DK", "EC", "EG", "FI", "FR", "DE", "GR", "HK", "HU", "IN", "ID", "IE", "IL", "IT", "JP", "KW", "LU", "MY", "MX", "MA", "NL", "NZ", "NG", "NO", "OM", "PK", "PA", "PE", "PH", "PL", "PT", "QA", "RO", "SA", "SG", "ZA", "KR", "ES", "SE", "CH", "TW", "TH", "TR", "UA", "AE", "GB", "UY", "VE", "VN" ], "type": "string", "description": "Indeed country site to search. Results come in the site's language and salaries in its currency.", "default": "US" }, "maxItemsPerSearch": { "title": "Max jobs per search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of jobs to save for each search (the keyword search and each search URL). Indeed's cursor stops at roughly 1,000 fetched rows, including duplicates; use `locationShards` or more search URLs to collect more.", "default": 100 }, "maxItems": { "title": "Max jobs for the whole run", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Optional hard cap across every search and pasted job URL. The run stops as soon as this many jobs are saved. Leave empty for no global cap." }, "shardByDate": { "title": "Split by date window", "type": "boolean", "description": "Run each keyword search five times, for the last 1, 3, 7, 14 and 30 days, and remove duplicates. Useful for freshness coverage when you need more than one cursor walk per search.", "default": false }, "jobType": { "title": "Job type", "enum": [ "", "fulltime", "parttime", "contract", "temporary", "internship", "permanent", "seasonal", "perdiem", "freelance", "apprenticeship", "volunteer" ], "type": "string", "description": "Employment type.", "default": "" }, "workplaceType": { "title": "Remote / hybrid / in-person", "enum": [ "", "remote", "hybrid", "inPerson" ], "type": "string", "description": "Where the work happens.", "default": "" }, "datePosted": { "title": "Date posted", "enum": [ "", "1", "3", "7", "14", "30" ], "type": "string", "description": "Only jobs added to Indeed within this period.", "default": "" }, "experienceLevel": { "title": "Experience level", "enum": [ "", "noExperience", "entry", "mid", "senior" ], "type": "string", "description": "Required experience level.", "default": "" }, "educationLevel": { "title": "Education level", "enum": [ "", "noDegree", "highSchool", "associate", "bachelor", "master", "doctoral" ], "type": "string", "description": "Required education.", "default": "" }, "salaryMin": { "title": "Minimum yearly salary", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Only jobs whose salary range reaches at least this yearly amount, in the country's currency (hourly and monthly pay is converted to yearly). Jobs without any salary information are excluded." }, "easyApplyOnly": { "title": "Easy apply only", "type": "boolean", "description": "Only jobs you can apply to directly on Indeed.", "default": false }, "radius": { "title": "Search radius", "minimum": 0, "maximum": 500, "type": "integer", "description": "Distance around the location (Indeed's default is 25). Ignored without a location." }, "radiusUnit": { "title": "Radius unit", "enum": [ "miles", "kilometers" ], "type": "string", "description": "Unit of the search radius.", "default": "miles" }, "sort": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Order of the search results.", "default": "relevance" }, "startUrls": { "title": "Indeed URLs", "type": "array", "description": "Indeed search result URLs (any country, with their filters), job URLs (`…/viewjob?jk=…`) or job IDs. Each search URL is scraped as its own search; job URLs are fetched directly. Filters chosen above are added to search URLs.", "items": { "type": "string" } }, "includeCompanyRatings": { "title": "Include full company report", "type": "boolean", "description": "Add the employer's HTML company report: CEO approval, founding year, work wellbeing scores and average salaries by job title, plus an industry fallback. Ratings, review count and the five category ratings are always included from Indeed's app API at no extra request; this toggle adds the fields that require one company-page fetch per employer. Turn off for the fastest, cheapest runs.", "default": true }, "includeSponsored": { "title": "Include sponsored flag", "type": "boolean", "description": "Add `isSponsored` from Indeed's mobile search page for jobs that also appear there. This costs one extra lightweight page per search and is best effort: jobs outside the first mobile result page keep the field omitted rather than guessed.", "default": true }, "includeDescriptionHtml": { "title": "Include description HTML", "type": "boolean", "description": "Also save the job description as HTML (`descriptionHtml`) with its formatting. The plain-text `description` is always included.", "default": false }, "saveOnlyUniqueItems": { "title": "Remove duplicates across searches", "type": "boolean", "description": "Save each job once even when several searches find it. Jobs are always unique within one search.", "default": true } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }