{ "openapi": "3.0.1", "info": { "title": "Cutshort Jobs Scraper", "description": "The Cutshort Jobs Scraper extracts Indian tech jobs from Cutshort.io by skill, role and city, capturing skills, experience ranges, remote policy, displayed salaries split into currency and period, company details and full descriptions — ideal for tech recruiting and salary research.", "version": "0.0", "x-build-id": "gW0ObFbmdiexQfUde" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~cutshort-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-cutshort-jobs-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/piotrv1001~cutshort-jobs-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-cutshort-jobs-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/piotrv1001~cutshort-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-cutshort-jobs-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": { "skills": { "title": "Skills or roles", "type": "array", "description": "Cutshort skills or roles to collect jobs for, e.g. `Python`, `React`, `DevOps`, `Data Science`, `Product Management`. Each one is matched to the Cutshort job list of the same name; terms that match no list are skipped with suggestions in the log.", "items": { "type": "string" } }, "city": { "title": "City", "enum": [ "", "bangalore-bengaluru", "mumbai", "delhi-ncr-gurgaon-noida", "hyderabad", "pune", "chennai", "ahmedabad", "kolkata", "jaipur", "indore", "coimbatore", "kochi-cochin", "chandigarh", "bhubaneswar" ], "type": "string", "description": "Only jobs from this city's list. Leave on All India for every location. When Cutshort has no list for a skill in this city, that skill is skipped rather than widened to all of India.", "default": "" }, "startUrls": { "title": "Cutshort URLs", "type": "array", "description": "Cutshort job list pages (e.g. `https://cutshort.io/jobs/reactjs-jobs-in-pune`) or single job pages (`https://cutshort.io/job/...`). Filters below apply to job lists; single job pages are always saved with full details.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Keep only jobs the employer marks as remote only. Jobs that are merely remote-friendly (`remote_okay`) are dropped. The label comes from the employer; check `descriptionText` for location conditions.", "default": false }, "experienceMin": { "title": "Minimum experience (years)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Keep jobs whose experience range overlaps your range, e.g. 2 keeps a 1–4 year job." }, "experienceMax": { "title": "Maximum experience (years)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Keep jobs whose experience range overlaps your range, e.g. 5 keeps a 3–8 year job but drops an 8–12 year job." }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Keep only jobs posted on or after this date. Lists run newest first, so the scraper stops once it reaches older jobs." }, "includeDetails": { "title": "Check job pages", "type": "boolean", "description": "Also open each job page to add whether the job is still open (`jobValid`), the recruiter's latest hiring activity date and role tags. Slower and charged as a job detail instead of a job listing.", "default": false }, "maxItems": { "title": "Max jobs", "minimum": 1, "type": "integer", "description": "Maximum number of jobs to save, counted after filters.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. The default Apify Proxy works well.", "default": { "useApifyProxy": 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 } } } } } } } } } }