{
  "openapi": "3.0.1",
  "info": {
    "title": "Freshersworld Scraper",
    "description": "[💰 $1 / 1K] Extract entry-level and fresher job listings from Freshersworld, India's graduate jobs board. Search by keyword, city, qualification, experience, and job type — each result includes title, company, salary, location, experience, qualification, apply link, and description.",
    "version": "1.0",
    "x-build-id": "uxsBRsgnQkzAOFJYK"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~freshersworld-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-freshersworld-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/solidcode~freshersworld-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-freshersworld-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/solidcode~freshersworld-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-freshersworld-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": {
          "searchKeyword": {
            "title": "Search Keyword",
            "type": "string",
            "description": "Word or phrase to search for across job titles, skills, and companies (e.g. 'software developer', 'data analyst', 'accountant'). Freshersworld searches in English, so a keyword needs letters or numbers — one made only of punctuation or of another script can't be searched and the run will say so instead of returning unrelated jobs. Leave blank to collect all jobs matching the filters below."
          },
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "Paste one or more Freshersworld job search, category, city, or qualification pages (e.g. a 'jobs in Bangalore' or 'B.Tech jobs' listing page). When provided, these are scraped directly and the keyword/filters below are ignored. Links that aren't Freshersworld pages are reported in the log and skipped; if none of them can be used the run stops and tells you, rather than quietly searching for something else.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "City / Location",
            "type": "string",
            "description": "Only include jobs in this city (e.g. 'Bangalore', 'Mumbai', 'Delhi', 'Hyderabad', 'Chennai'). Freshersworld applies this filter on its own search for the ~890 cities it lists, so the results come back already narrowed to that city — by far the fastest way to run a city search. Both common spellings work ('Bangalore' also finds 'Bengaluru'), and cities that were renamed are searched under both names, so 'Gurgaon' also returns jobs filed under 'Gurugram'. Because the filter is Freshersworld's own, a job hiring in several cities is included whenever that city is one of them. A place Freshersworld doesn't list as a city — a state or region such as 'Karnataka', or a misspelling — is checked against each job as the results come in instead, which is slower: if 15 result pages in a row contain no matching jobs the run stops early and reports why. Leave blank for jobs across all of India."
          },
          "jobTypes": {
            "title": "Job Types",
            "uniqueItems": true,
            "type": "array",
            "description": "Only include jobs of these employment types. Leave empty to include all types. Freshersworld applies this filter on its own search, so results are narrowed at the source — picking several types returns jobs matching any of them. Note on 'Work From Home': it comes from Freshersworld's own dedicated remote-jobs listing, which is much smaller than the main board (typically a few dozen live jobs) and cannot be narrowed by keyword at the source — so combining it with a search keyword filters that small list further and can return very few results. For the widest remote coverage, select Work From Home and leave the keyword blank. If 15 result pages in a row contain no matching jobs, the run stops early and reports why.",
            "items": {
              "type": "string",
              "enum": [
                "full_time",
                "part_time",
                "internship",
                "apprenticeship",
                "work_from_home"
              ],
              "enumTitles": [
                "Full Time",
                "Part Time",
                "Internship",
                "Apprenticeship",
                "Work From Home"
              ]
            },
            "default": []
          },
          "experience": {
            "title": "Experience Level",
            "enum": [
              "any",
              "fresher",
              "0-1",
              "1-3",
              "3-plus"
            ],
            "type": "string",
            "description": "Only include jobs matching this experience level. Freshersworld focuses on entry-level roles, so most jobs suit freshers. Ranges overlap on purpose — a job advertised as '0 to 2 years' is open to freshers and to candidates with 1-3 years, so it is returned for both. This is the one filter Freshersworld cannot apply on its own search without dropping jobs that genuinely match, so each job is checked as the results come in: if 15 result pages in a row contain no matching jobs, the run stops early and reports why.",
            "default": "any"
          },
          "qualifications": {
            "title": "Qualifications",
            "uniqueItems": true,
            "type": "array",
            "description": "Only include jobs open to these degrees or courses. Leave empty to include all qualifications. Picking several returns jobs open to any of them. Freshersworld applies this filter on its own search, so results are narrowed at the source. Two cases are checked against each job as the results come in instead: 'Any Graduate', which Freshersworld has no ready-made filter for, and very large mixes of job types and qualifications chosen together. In those cases, if 15 result pages in a row contain no matching jobs, the run stops early and reports why — broaden the selection for more results.",
            "items": {
              "type": "string",
              "enum": [
                "be_btech",
                "me_mtech",
                "mba",
                "mca",
                "bca",
                "bsc",
                "msc",
                "bcom",
                "mcom",
                "ba",
                "ma",
                "diploma",
                "iti",
                "bpharm",
                "llb",
                "12th",
                "10th",
                "any_graduate"
              ],
              "enumTitles": [
                "BE / B.Tech",
                "ME / M.Tech",
                "MBA / PGDM",
                "MCA",
                "BCA",
                "B.Sc",
                "M.Sc",
                "B.Com",
                "M.Com",
                "BA",
                "MA",
                "Diploma",
                "ITI",
                "B.Pharma",
                "LLB",
                "12th Pass",
                "10th Pass",
                "Any Graduate"
              ]
            },
            "default": []
          },
          "maxResults": {
            "title": "Maximum Results",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap on the total number of job listings to collect. Default 100 — increase for bigger runs, or set to 0 for no cap. Two built-in limits still apply so a run can never grow unbounded: with no cap set, a run collects at most 50,000 results in total; and any single search is read to a maximum of 3,000 result pages (60,000 jobs). A run also has a time budget that grows with the number of results you ask for (at least 15 minutes, about 3 seconds per requested result, never more than 6 hours) — it only ever comes into play when a very narrow combination of filters matches too few jobs per page to finish. Whenever any of these limits is what ends a run, the completion message says so. The run stops requesting new pages once your number is reached but keeps the full last page even if it slightly overshoots.",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}