Egypt CAOA Government Jobs Scraper

Collect public vacancy notices from Egypt's Central Agency for Organization and Administration (CAOA) Government Jobs Portal. The Actor reads the portal's public search sections and can open each public notice for its requirements and application details. It does not sign in, submit applications, or access applicant records.

Features

• Collects appointments and contracts, leadership/supervisory vacancies, and optionally internal government transfers.
• Extracts job title, hiring entity, closing date, positions count, purpose, duties, age and experience criteria, required documents, qualifications, and application location when available.
• Follows public detail links implemented as portal postbacks and preserves source URLs and identifiers.
• Deduplicates notices, limits pages and output records, and keeps request concurrency at one.
• Respects robots.txt and stops on access-denied pages or challenges; it does not use proxies or bypass controls.
• Saves run metrics in the default key-value store under STATS.

Scope and limitations

This is a snapshot of vacancies published through the CAOA portal. It covers Egyptian government hiring only, not private-sector jobs or the full Egyptian labor market. The portal separates appointment/contract vacancies, internal transfers for current government employees, and leadership/supervisory positions. Internal transfers are excluded by default. Fields omitted by an announcement remain null; the Actor does not infer salaries, active status, or hiring outcomes.

The portal uses postback links for some notices. If a notice detail cannot be opened, the list entry is still saved with detail_status set to failed. Portal page structures and available announcements may change.

Use cases

• Snapshot public Egyptian government vacancies and application deadlines.
• Compare advertised role titles and hiring agencies across portal categories.
• Build a transparent, source-bounded public-sector job-notice analysis.

Input

The default input collects up to 50 notices from appointment/contract and leadership/supervisory sections, with notice details enabled. The prefilled input is limited to five notices for a short test run.

Field	Default	Meaning
maxItems	50	Maximum unique records to save, from 1 to 500.
workTypes	[1, 3]	1: appointment/contract; 2: current-government-employee transfers; 3: leadership/supervisory.
includeDetails	true	Open public notice details for requirements and application information.
maxPagesPerType	5	Pagination safety cap for each selected category, from 1 to 20.

Example input:

{"maxItems": 5, "workTypes": ["1", "3"], "includeDetails": true, "maxPagesPerType": 2}

Output

One dataset item per unique portal vacancy. Dates are normalized to YYYY-MM-DD. job_url is null when a notice could not be opened or the listing has no direct detail URL.

{
  "job_id": "ATmv+LLNmNAQ7T/O1LNpKw==",
  "job_title": "مدرس كلية الطب بنين اسيوط",
  "hiring_entity": "جامعة الأزهر",
  "affiliated_entity": "جهات تابعة لمجلس الوزاراء",
  "positions_count": 3,
  "positions_text": "3",
  "job_purpose": "عدد درجة واحدة لقسم جراحة الاوعية الدموية...",
  "duties": "يشترط فيمن يتقدم لشغل وظيفة مدرس...",
  "max_age": "50 عام",
  "experience_requirements": "يشترط توافر الكفاءة للتدريس",
  "application_deadline": "2026-10-15",
  "required_documents": "طلب باسم السيد أ.د/ نائب رئيس الجامعة...",
  "submission_location": "التقدم بالكلية المعلن عنها",
  "qualification_requirements": "ان يكون حاصلا على الدكتوراة او ما يعادلها...",
  "work_type": 1,
  "announcement_type": "Appointment and contract",
  "country": "Egypt",
  "source": "CAOA Government Jobs Portal",
  "job_url": "https://jobs.caoa.gov.eg/Jobs/ShowJob.aspx?JobID=ATmv+LLNmNAQ7T/O1LNpKw==",
  "source_search_url": "https://jobs.caoa.gov.eg/Jobs/SearchJobs.aspx?WorkType=1",
  "source_link_id": "ContentPlaceHolder1_grdAdvert_grdJobs_0_lbJobs_0",
  "detail_status": "complete",
  "scraped_at": "2026-10-06T12:00:00.000Z"
}

Exact source text may contain long government notice criteria and document lists. Keep the source attribution and describe any published analysis as CAOA public-sector announcements, not employment or hiring totals.

Local development

npm install
npm test
apify run --input='{"maxItems":2,"workTypes":["1"],"includeDetails":true,"maxPagesPerType":1}'

FAQ

Does this represent the whole Egyptian job market? No. It only represents notices visible on the CAOA Government Jobs Portal.

Why are salary or location absent? The public portal notice fields inspected do not consistently provide them. Missing values are left empty rather than guessed.

Does it include jobs for private employers? No. This source is limited to government vacancies. Select work type 2 only for internal transfer/secondment notices aimed at existing government employees.

What happens if a detail page fails? The Actor saves the listing entry with detail_status set to failed and reports the failure in STATS.

Can I compare runs? Yes. Retain job_id and scraped_at. Counts describe each collection snapshot; they are not historical hiring or employment statistics.