{
"openapi": "3.0.1",
"info": {
"title": "Cutshort Jobs Scraper",
"description": "Scrape Cutshort.io tech jobs in India by skill, role, city or remote, or from any Cutshort jobs page: title, company, salary range (also when hidden), experience, skills, locations, posted date, full description. Filters for date, salary and job type. Pay per result: $1 per 1,000 jobs, no login.",
"version": "1.0",
"x-build-id": "YPi0nnoFueLvSEbx2"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/brii3343~cutshort-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-brii3343-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/brii3343~cutshort-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-brii3343-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/brii3343~cutshort-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-brii3343-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": {
"searchQueries": {
"title": "Skills or roles",
"type": "array",
"description": "What to search, one per line: a skill or a role, optionally with a city or the word remote, for example python, react developer in pune, remote golang, data engineer, python nagpur. Each line opens the matching Cutshort jobs page (about 3,800 skill and role pages; roles like data engineer are mapped to the site's page; 14 city pages, other places are matched in the job locations); the page used is in listPage.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Cutshort jobs pages",
"type": "array",
"description": "Cutshort jobs list pages, for example https://cutshort.io/jobs/python-jobs, https://cutshort.io/jobs/reactjs-jobs-in-pune or https://cutshort.io/jobs/remote-golang-jobs. Company pages are read in full, 10 jobs per page, for example https://cutshort.io/company/vy-systems-private-limited-16-e43Khktp. Single job pages are not supported.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"postedWithinDays": {
"title": "Posted in the last N days",
"minimum": 0,
"type": "integer",
"description": "Only jobs posted in the last N days. Empty or 0 = all jobs the page lists (Cutshort pages also list older jobs that are still open)."
},
"postedWithinHours": {
"title": "Posted in the last N hours",
"minimum": 0,
"type": "integer",
"description": "Only jobs posted in the last N hours, for example 24 for the last day or 6 for a frequent schedule. Empty or 0 = no limit. If you also set the days field, the narrower limit applies."
},
"minSalary": {
"title": "Minimum yearly salary (INR)",
"minimum": 0,
"type": "integer",
"description": "Only jobs whose salary range reaches at least this amount per year in Indian rupees, for example 2000000 for 20 lakh. Monthly salaries are multiplied by 12 before the comparison. Jobs without a salary, or paid in another currency, are left out when this is set. Empty or 0 = no limit."
},
"remoteOnly": {
"title": "Remote jobs only",
"type": "boolean",
"description": "Only jobs Cutshort marks as fully remote (remoteType remote_only)."
},
"jobTypes": {
"title": "Job types",
"type": "array",
"description": "Only these job types. Empty = all.",
"items": {
"type": "string",
"enum": [
"full_time",
"internship"
],
"enumTitles": [
"Full time / contract",
"Internship"
]
}
},
"maxItemsPerSource": {
"title": "Max jobs per search or URL",
"minimum": 0,
"type": "integer",
"description": "Jobs to save for each line and each URL. 0 = everything the page lists.",
"default": 50
},
"maxItems": {
"title": "Max jobs in total",
"minimum": 0,
"type": "integer",
"description": "Stop after this many jobs in the whole run. 0 = no limit.",
"default": 0
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Not needed: the scraper connects directly and switches to Apify Proxy by itself only when Cutshort blocks it. Set a proxy here only to force one.",
"default": {
"useApifyProxy": false
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}