Tunisia Tanitjobs Jobs Scraper

Collect publicly visible job listings from Tanitjobs Tunisia. The Actor captures the listing URL and source page for traceability, and can optionally open job detail pages for additional fields.

Important access note

Tanitjobs currently serves a Cloudflare security-verification page to some automated and browser requests. This Actor detects that response and does not solve or bypass the challenge. A successful local test crawl depends on Tanitjobs making the public page accessible to the Actor. The parser and crawler behavior can be tested offline with the included fixtures.

Features

• Crawl the jobs feed or user-supplied Tanitjobs search pages.
• Follow observed result-page pagination, within a configurable page limit.
• Deduplicate listings by Tanitjobs job ID.
• Optionally enrich results from job detail pages.
• Extract job title, company, location/governorate, contract, work mode, salary, vacancy count, experience, education, languages, description, source date text, expiry date text, and keywords when present.
• Preserve source date text as published; dates are not guessed or silently normalized.
• Save run diagnostics in the STATS key-value record.

Use cases

• Build a dated snapshot of public job advertisements on Tanitjobs.
• Explore advertised roles by Tunisian governorate, contract, and employer.
• Prepare a source-specific job-market report. This dataset is not a census of Tunisia's labor market and should not be combined with other portals as if the sources covered the same population.

Input

{
  "startUrls": [{"url": "https://www.tanitjobs.com/jobs/"}],
  "maxItems": 100,
  "maxPages": 10,
  "includeDetails": true,
  "maxConcurrency": 1
}

• startUrls: optional Tanitjobs /jobs/ search pages or /job/{id}/ detail pages.
• maxItems: maximum unique records to save (1-5,000).
• maxPages: maximum listing pages followed for each listing start URL (1-100).
• includeDetails: open job detail pages for fields not present in listing cards.
• maxConcurrency: capped at 3; default is 1 to keep requests conservative.

Output

One dataset item per unique job listing. Fields that Tanitjobs does not provide remain null or an empty array. date_posted_raw and expiration_date_raw retain source text, which may be relative (for example, “Il'y a 2 jours”) or a local date format.

{
  "listing_id": "1980860",
  "job_title": "COMPTABLE FOURNISSEUR",
  "company_name": "Infopro digital",
  "location": "Ariana, Tunisie",
  "governorate": "Ariana",
  "contract_type": "CDI, SIVP",
  "work_mode": null,
  "salary": null,
  "vacancies": 1,
  "experience_level": "1 à 3 ans",
  "education_level": "Licence, Bac + 3",
  "languages": "Français",
  "description": "Description as published by the employer...",
  "date_posted_raw": "Il'y a 2 jours",
  "expiration_date_raw": "29/10/2026",
  "keywords": ["Comptabilité", "CDI"],
  "job_url": "https://www.tanitjobs.com/job/1980860/comptable-fournisseur/",
  "source_page_url": "https://www.tanitjobs.com/jobs/",
  "scraped_at": "2026-10-02T12:00:00.000Z"
}

Local development

npm install
npm test
apify run --input='{"maxItems":5,"maxPages":1,"includeDetails":false}'

FAQ

Why did the run fail with a security verification message?

Tanitjobs or its security provider did not serve the public listing to that request. The Actor does not solve challenges or disguise automated access. Retry only when the page is accessible through normal, permitted means, or use an authorized data feed from the site.

Does this contain every job in Tunisia?

No. It contains records collected from Tanitjobs pages visited during a particular run. Listings can be duplicated, edited, removed, or expire, and many employers use other channels.

Are dates normalized?

No. Date strings are retained in *_raw fields to avoid converting relative or ambiguous dates into misleading timestamps.