{
  "openapi": "3.0.1",
  "info": {
    "title": "Naukri Scraper",
    "description": "Naukri Scraper is a fast, reliable Apify Actor that extracts detailed job listings from India’s top portal, naukri.com. Perfect for recruiters and analysts, it captures job titles, companies, salaries, experience, skills, and full descriptions using API scraping for accurate, up-to-date data.",
    "version": "1.0",
    "x-build-id": "CO8nx3HVy5cVsj8jV"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/epicscrapers~naukri-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-epicscrapers-naukri-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/epicscrapers~naukri-scraper/runs": {
      "post": {
        "operationId": "runs-sync-epicscrapers-naukri-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/epicscrapers~naukri-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-epicscrapers-naukri-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": {
          "startUrls": {
            "title": "Naukri Search URLs",
            "type": "array",
            "description": "Enter Naukri search result URLs. Each URL's query parameters (e.g. <code>?experience=2</code>) are extracted to set keyword, location, and filters for that search.",
            "items": {
              "type": "string"
            }
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Job title, skill, or company to search for. Examples: <code>react developer</code>, <code>python</code>, <code>data scientist</code>, <code>tcs</code>."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "City or area to narrow results. Examples: <code>bangalore</code>, <code>mumbai</code>, <code>delhi ncr</code>, <code>pune</code>. Leave empty for all locations."
          },
          "experience": {
            "title": "Experience Range (Years)",
            "type": "string",
            "description": "Filter by years of experience. Format: <code>min-max</code>. Example: <code>2-5</code> means 2 to 5 years. Leave empty for any experience."
          },
          "companyName": {
            "title": "Company Name",
            "type": "string",
            "description": "Filter results to a specific company. Example: <code>Google</code>, <code>TCS</code>, <code>Infosys</code>."
          },
          "jobAge": {
            "title": "Job Age (Freshness)",
            "enum": [
              "",
              "1",
              "3",
              "7",
              "15",
              "30"
            ],
            "type": "string",
            "description": "Show only jobs posted within this time frame.",
            "default": ""
          },
          "sort": {
            "title": "Sort Order",
            "enum": [
              "relevance",
              "date"
            ],
            "type": "string",
            "description": "Sort results by relevance or by most recent first.",
            "default": "relevance"
          },
          "ctcFilter": {
            "title": "Annual Salary (CTC)",
            "enum": [
              "",
              "0to3",
              "3to6",
              "6to10",
              "10to15",
              "15to25",
              "25to50",
              "50to75",
              "75to100",
              "100to500"
            ],
            "type": "string",
            "description": "Filter by expected annual salary range.",
            "default": ""
          },
          "jobTypeFilter": {
            "title": "Employment Type",
            "enum": [
              "",
              "P",
              "C",
              "V",
              "T",
              "I"
            ],
            "type": "string",
            "description": "Filter by type of employment.",
            "default": ""
          },
          "maxResultsPerQuery": {
            "title": "Max Results Per Query",
            "type": "integer",
            "description": "Maximum number of job listings to scrape per URL or keyword search. Set to <code>0</code> for no limit. Start with a low number (e.g. 10) to test before scaling up.",
            "default": 50
          },
          "fetchAdditionalDetails": {
            "title": "Fetch Additional Details",
            "type": "boolean",
            "description": "If enabled, fetches extra metadata for each job listing (apply deadline, questionnaire eligibility, template IDs, etc.). Jobs are processed in batches of 10, adding a small amount of time. Useful for deeper analysis but not needed for basic results.",
            "default": false
          },
          "proxyConfig": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Optional proxy to avoid rate limiting. For large scrapes, enable <b>Residential proxies</b> to reduce the chance of IP blocks."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}