NCS Jobs Search Scraper

This Apify Actor extracts complete public job records from India's National Career Service (NCS), using the current public /job-listing experience and its first-party API. It is designed for bounded local verification and does not log in, submit applications, use a browser, create a proxy, or publish through the Apify API.

Source and transport

• Public site: https://ncs.gov.in/job-listing
• Public search API: https://api.ncs.gov.in/api/v1/job-posts/search
• Public detail API: https://api.ncs.gov.in/api/jobs/detail?id={id}
• Transport: native Node.js fetch
• API envelope: the same AES-256-CBC JSON envelope used by the public NCS application
• Output: one verified detail record per job, plus structured diagnostics when a public request is unavailable or malformed

Search results provide stable numeric IDs, titles, organizations, descriptions, locations, skills, employment type, experience, salary, vacancy, and date fields. Detail responses are fetched and identity-checked before a job row is written. Recruiter email/mobile/name/designation fields are omitted, and phone/email patterns in descriptions and source snapshots are redacted.

Input

The full input contract is in .actor/input_schema.json.

Example:

{
  "mode": "search",
  "query": "nurse",
  "location": "",
  "maxItems": 3,
  "maxCandidates": 12,
  "maxPages": 2,
  "maxDetailRequests": 12,
  "maxRequests": 24,
  "deadlineSeconds": 120,
  "timeoutMs": 20000,
  "retries": 1
}

Supported modes:

• search: one query and optional location.
• searchMultiple: several values in queries (aliases: searchQueries, keywords).
• single: one official jobUrl, such as https://ncs.gov.in/job-listing/applying/3034525.
• multiple: official URLs in jobUrls.
• startUrls: official /job-listing and/or /job-listing/applying/{id} URLs.

The legacy query, location, maxItems, jobUrl, jobUrls, and proxyConfiguration fields remain accepted for compatibility. Proxy configuration is intentionally ignored because this implementation uses direct public HTTPS.

Output

The dataset schema is in .actor/dataset_schema.json. Job rows include:

• stable jobId, title, employer, organization, sector, functional area/role;
• normalized locations with city, state, pincode, and coordinates when supplied;
• redacted full description, summary, skills, education, experience, salary, employment type, gender, openings, posting date, and deadline;
• canonical NCS detail URL and source-backed external apply URL when the API supplies one;
• search context, request receipts, sanitized sourceData, detail identity checks, and data-quality metrics.

The dataset contains complete jobs only. RUN_SUMMARY, OUTPUT_SUMMARY, RUN_DIAGNOSTICS, RUN_METADATA, and RUN_HEALTH are written to the default key-value store for local or cloud evidence. maxRequests caps total HTTP attempts including retries, and deadlineSeconds stops new requests at the run deadline. Metadata does not persist raw proxy-capable input.

Responsible use

Collect only publicly available job information. Respect NCS terms, robots directives, applicable data-protection requirements, and reasonable request rates. Do not use this Actor to access authenticated pages, bypass controls, submit applications, or harvest candidate/recruiter personal data.