{
  "openapi": "3.0.1",
  "info": {
    "title": "Cutshort Jobs Scraper - India Tech Jobs, Salary & Companies",
    "description": "Scrape Cutshort (cutshort.io) India tech and startup jobs: title, salary in INR and lakhs, skills, experience, remote type, full description, recruiter activity (ghost jobs), company profile and employer email. Any skill, city or company, monitor mode. $0.039 per 1,000 jobs.",
    "version": "0.1",
    "x-build-id": "k9ftcbEmooUApLwRZ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~cutshort-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-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/topapi~cutshort-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-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/topapi~cutshort-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-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": "One search per skill or role, matched to Cutshort's job category, e.g. \"python\", \"react\", \"product manager\", \"remote golang\", \"java in pune\". Empty (with no link or company) = Python jobs.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Cutshort links",
            "type": "array",
            "description": "Category pages (cutshort.io/jobs/python-jobs, /jobs/reactjs-jobs-in-pune, /jobs/remote-golang-jobs), job pages (cutshort.io/job/...) and company pages (cutshort.io/company/...).",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "companies": {
            "title": "Companies",
            "type": "array",
            "description": "Every open job of these companies: Cutshort company links, aliases or names, e.g. \"https://cutshort.io/company/techjays-92-tGmHamzp\", \"Techjays\".",
            "items": {
              "type": "string"
            }
          },
          "allCutshortJobs": {
            "title": "Every job on Cutshort",
            "type": "boolean",
            "description": "Read the whole job board (Cutshort's job sitemap, ~45,000 live jobs, most recently updated first) instead of categories. Combine with Locations and the filters below.",
            "default": false
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Cities or \"Remote\", e.g. \"Bangalore\", \"Pune\", \"Delhi NCR\", \"Remote\". Cutshort's 14 city pages are read directly (deeper than the India-wide page); other places filter the jobs' locations.",
            "items": {
              "type": "string"
            }
          },
          "remoteOnly": {
            "title": "Remote only",
            "type": "boolean",
            "description": "Only fully remote jobs (Cutshort's remote_only). Reads the category's remote page when Cutshort has one.",
            "default": false
          },
          "workplace": {
            "title": "Workplace",
            "enum": [
              "any",
              "remote",
              "remoteAllowed",
              "onSite",
              "notRemote"
            ],
            "type": "string",
            "description": "Cutshort's remote type of each job: remote_only, remote_okay (remote friendly), remote_not_okay (on-site).",
            "default": "any"
          },
          "roleTypes": {
            "title": "Job type",
            "type": "array",
            "description": "Cutshort's role types. Empty = both.",
            "items": {
              "type": "string",
              "enum": [
                "full_time",
                "internship"
              ],
              "enumTitles": [
                "Full time / contractual",
                "Internship"
              ]
            }
          },
          "postedWithin": {
            "title": "Posted within",
            "enum": [
              "anyTime",
              "past24Hours",
              "past3Days",
              "pastWeek",
              "past2Weeks",
              "pastMonth",
              "past3Months"
            ],
            "type": "string",
            "description": "By the posting date. Pages are read newest first, so a short window is fast and cheap. Pairs with a daily schedule.",
            "default": "anyTime"
          },
          "postedWithinHours": {
            "title": "Posted within (hours)",
            "minimum": 1,
            "maximum": 8760,
            "type": "integer",
            "description": "Any number of hours, e.g. 6 or 48. Overrides \"Posted within\"."
          },
          "experienceMinYears": {
            "title": "Experience from (years)",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Keeps jobs whose experience range reaches this many years."
          },
          "experienceMaxYears": {
            "title": "Experience up to (years)",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Keeps jobs open to candidates with at most this many years. 0 = jobs for freshers."
          },
          "minYearlySalary": {
            "title": "Minimum salary (INR a year)",
            "minimum": 0,
            "type": "integer",
            "description": "Keeps jobs whose shown salary reaches this much a year, in INR (other currencies converted by Cutshort), e.g. 1000000 = ₹10 L. Hidden salaries are removed."
          },
          "withSalaryOnly": {
            "title": "Only jobs that show a salary",
            "type": "boolean",
            "description": "Skip jobs whose salary is hidden (\"Best in industry\").",
            "default": false
          },
          "companyStages": {
            "title": "Company stage",
            "type": "array",
            "description": "As the company states on Cutshort. Empty = any.",
            "items": {
              "type": "string",
              "enum": [
                "bootstrapped",
                "raisedFunding",
                "profitable"
              ],
              "enumTitles": [
                "Bootstrapped",
                "Raised funding",
                "Profitable"
              ]
            }
          },
          "companyType": {
            "title": "Company type",
            "enum": [
              "any",
              "product",
              "services"
            ],
            "type": "string",
            "description": "\"Products & Services\" companies count as both.",
            "default": "any"
          },
          "postedBy": {
            "title": "Posted by",
            "enum": [
              "any",
              "company",
              "agency"
            ],
            "type": "string",
            "description": "Agencies post for clients, often under a described name (\"MNC\"). Every row says postedByType and hiringForClient.",
            "default": "any"
          },
          "titleMustMatchKeyword": {
            "title": "Title must contain the skill",
            "type": "boolean",
            "description": "A category also holds jobs that only list the skill (a Java job with Python in its skills). On = only titles with every word of the skill.",
            "default": false
          },
          "titleInclude": {
            "title": "Title contains",
            "type": "array",
            "description": "Keep a job when its title contains any of these, e.g. \"senior\", \"lead\", \"intern\".",
            "items": {
              "type": "string"
            }
          },
          "titleExclude": {
            "title": "Title does not contain",
            "type": "array",
            "description": "Skip a job when its title contains any of these, e.g. \"manager\", \"sales\".",
            "items": {
              "type": "string"
            }
          },
          "companyNames": {
            "title": "Company name contains",
            "type": "array",
            "description": "Keep only jobs whose company (or posting agency) name contains any of these.",
            "items": {
              "type": "string"
            }
          },
          "companyExclude": {
            "title": "Exclude companies",
            "type": "array",
            "description": "Company or agency names (or parts) to skip.",
            "items": {
              "type": "string"
            }
          },
          "hideGhostJobs": {
            "title": "Hide ghost jobs",
            "type": "boolean",
            "description": "Skip jobs whose recruiter has shown no hiring activity (with Job page details; otherwise the posting date) for \"Ghost after\" days. Off = every job, with ghostJob true / false.",
            "default": false
          },
          "ghostAfterDays": {
            "title": "Ghost after (days)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "A job is a ghost when its recruiter's last hiring activity (or its posting date) is older than this.",
            "default": 90
          },
          "skipJobsWithRedFlags": {
            "title": "Skip jobs with red flags",
            "type": "boolean",
            "description": "Skip jobs that ask for a fee, send you to WhatsApp, a phone number or a Gmail address, promise easy money, show a 4x salary range or hide the client. Every row lists its redFlags either way.",
            "default": false
          },
          "skipDuplicates": {
            "title": "Skip reposted copies",
            "type": "boolean",
            "description": "Same title, company and city = one job (companies post one job many times). Copies are free.",
            "default": true
          },
          "includeDetails": {
            "title": "Job page details",
            "type": "boolean",
            "description": "Also read each job's own page: the recruiter's last hiring activity (ghost-job check), job still valid, match tags, valid-through date, agency or company. $0.0009 per job with its page. Job links always include it.",
            "default": false
          },
          "includeCompanyDetails": {
            "title": "Company details",
            "type": "boolean",
            "description": "Company description, tech stack, FAQs, team members and photos on every row (stage, size, founded, website, LinkedIn are always there). Free.",
            "default": true
          },
          "includeCompanyProfile": {
            "title": "Company profile page",
            "type": "boolean",
            "description": "Read each company's Cutshort profile once: open jobs, recruitment agency or not, tech team size, planned developer hires, typical developer salary, domains, hiring team. Free.",
            "default": false
          },
          "includeRecruiter": {
            "title": "Recruiter",
            "type": "boolean",
            "description": "The name, id and picture of the person who posted the job, as shown on the job.",
            "default": true
          },
          "enrichEmails": {
            "title": "Employer email",
            "type": "boolean",
            "description": "A contact email from the hiring company's own website (the one on its Cutshort profile; for an agency job without a client name, the agency's). $0.0072 per employer with an email found, once per run.",
            "default": false
          },
          "readCityPages": {
            "title": "Read city and remote pages",
            "type": "boolean",
            "description": "A Cutshort category page shows only its newest 400-650 jobs (python: 400 of 4,341). When it runs out, also read the same category's 14 city pages and its remote page.",
            "default": true
          },
          "liveData": {
            "title": "Live pages",
            "type": "boolean",
            "description": "Build every page fresh for this run. Off (default) = pages at most 1 hour old: a page read in the last hour answers in ~0.5 s; a fresh build can wait up to 25 s. Each row says how old its page was.",
            "default": false
          },
          "monitoringMode": {
            "title": "Only new jobs (monitor)",
            "type": "boolean",
            "description": "Remember the jobs of earlier runs with the same input and state name; return only new (and changed) ones. Jobs seen before are free. Pairs with a schedule.",
            "default": false
          },
          "stateName": {
            "title": "State name",
            "type": "string",
            "description": "Separate memory per monitor, e.g. \"python-pune\".",
            "default": "default"
          },
          "includeUnchanged": {
            "title": "Also return unchanged jobs",
            "type": "boolean",
            "description": "In monitor mode, also return (and charge) jobs seen before whose content did not change, marked UNCHANGED.",
            "default": false
          },
          "emitExpired": {
            "title": "Report closed jobs",
            "type": "boolean",
            "description": "In monitor mode, re-check remembered jobs not seen for a day; a job Cutshort deactivated or removed comes back as a row with changeType EXPIRED (charged as a job).",
            "default": false
          },
          "resetMonitoringState": {
            "title": "Reset the memory",
            "type": "boolean",
            "description": "One run: forget the jobs remembered so far (after changing a search, or to rebuild the baseline).",
            "default": false
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "POST the new jobs of each run (JSON) to your own endpoint."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook",
            "type": "string",
            "description": "Slack incoming-webhook URL for a message per run with new jobs."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook",
            "type": "string",
            "description": "Discord webhook URL."
          },
          "telegramToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Your Telegram bot's token (with the chat id below)."
          },
          "telegramChatId": {
            "title": "Telegram chat id",
            "type": "string",
            "description": "Chat or channel id the bot posts to."
          },
          "maxItems": {
            "title": "Max jobs",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Most jobs to return in this run (0 = no limit). A category shows 400-650 jobs; with its city and remote pages python reaches ~2,500.",
            "default": 50
          },
          "maxItemsPerSearch": {
            "title": "Max jobs per search",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Cap for each skill x location, link and company. Empty = shared from Max jobs."
          },
          "outputMode": {
            "title": "Output",
            "enum": [
              "full",
              "summary",
              "urls_only"
            ],
            "type": "string",
            "description": "Full returns every field; Summary the core job fields; Links only the job identity and links.",
            "default": "full"
          },
          "descriptionFormat": {
            "title": "Description",
            "enum": [
              "text",
              "html",
              "both",
              "none"
            ],
            "type": "string",
            "description": "Plain text keeps paragraphs and bullet points.",
            "default": "text"
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Job pages read at once.",
            "default": 8
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Not needed: cutshort.io answers directly. The actor moves to Apify's proxies by itself if a request is refused.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}