Algeria Jobs Scraper - Ouedkniss

Scrape Algerian employment listings from Ouedkniss, one of the country's largest classified marketplaces. Collect structured job data in French or Arabic for recruitment research, HR analytics, lead generation, and job-market monitoring.

Features

• Collects job titles, companies, wilayas, locations, salaries, contracts, experience, education, dates, descriptions, skills, and canonical URLs.
• Supports French and Arabic listings.
• Follows result-page pagination with configurable limits.
• Uses browser rendering for dynamic Ouedkniss pages.
• Saves run statistics and diagnostic HTML snapshots when the source structure changes.
• Supports optional Apify Proxy configuration when direct requests are blocked.

Use cases

• Build an Algeria job-market dataset for dashboards and analysis.
• Monitor hiring demand by wilaya, role, company, or skill.
• Create recruitment and B2B lead lists from public job postings.
• Track salary and contract signals across Algerian listings.
• Feed normalized job records into an HR or AI pipeline.

Input

The default input starts from the Ouedkniss employment feed:

{
  "startUrls": [
    {"url": "https://www.ouedkniss.com/emploi_offres/1?lang=fr"}
  ],
  "maxListings": 100,
  "maxPages": 5,
  "includeDetails": true,
  "maxConcurrency": 2,
  "proxyConfiguration": {"useApifyProxy": true}
}

startUrls accepts Ouedkniss employment or search pages. Set maxListings to 0 to collect every listing found on the selected pages. The default uses Apify Proxy because direct requests may time out; disable it only after confirming the source is reachable from your environment.

Output

Each dataset item uses a stable, analysis-friendly structure:

{
  "job_title": "Data Engineer",
  "company_name": "Example Algeria",
  "wilaya": "Alger",
  "location": "Alger",
  "salary": "150 000 DA",
  "contract_type": "CDI",
  "experience_level": "2 years",
  "education_level": "Engineering degree",
  "description": "Build reliable data pipelines.",
  "skills": ["python", "sql"],
  "date_posted": "2026-09-24",
  "job_url": "https://www.ouedkniss.com/annonce/emploi/example-123",
  "source_listing_url": "https://www.ouedkniss.com/emploi_offres?lang=fr",
  "source_language": "fr",
  "scraped_at": "2026-09-24T12:00:00.000Z"
}

The overview dataset view is ready for browsing and exports. Run metrics are saved under the STATS key in the default key-value store.

How to use

1. Open the Actor in Apify Console.
2. Add an Ouedkniss employment or search URL, or use the default feed.
3. Set the maximum number of listings and pages.
4. Enable Apify Proxy if the source blocks direct traffic.
5. Start the run and export the dataset as JSON, CSV, or Excel.

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("scraper_guru/algeria-jobs-scraper").call(run_input={
    "maxListings": 100,
    "maxPages": 5,
    "includeDetails": True
})

items = list(client.dataset(run["defaultDatasetId"]).iterate_items())

JavaScript

import { Actor } from 'apify-client';

const client = new Actor({ token: process.env.APIFY_TOKEN });
const run = await client.actor('scraper_guru/algeria-jobs-scraper').call({
    maxListings: 100,
    maxPages: 5,
    includeDetails: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Pricing

This Actor uses Apify pay-per-event pricing. Check the Actor page for the current per-result price and platform usage charges. The final cost depends on the number of records returned and whether detail pages are opened.

Analyze a collected snapshot

After downloading the Actor dataset into storage/datasets/default, generate charts and reports with:

python analysis/analyze_jobs.py \
  --input storage/datasets/default \
  --output analysis/output

The analysis creates normalized CSV data, summary tables, PNG/SVG charts, a chart contact sheet, market_report.md, and Reddit/LinkedIn drafts. See analysis/README.md for the methodology and caveats.

Data quality and limitations

Ouedkniss listings may be written in French, Arabic, or a mix of both. Salary, company, experience, and education fields are only populated when the publisher provides them. Site layout changes can affect extraction; failed or empty pages leave a diagnostic snapshot in the key-value store.

Use the data responsibly, follow Ouedkniss terms and applicable law, and respect privacy and contact preferences.

FAQ

Does it scrape Arabic listings?

Yes. The crawler accepts Arabic pages and records a source_language field when Arabic text is detected.

Can I target a specific wilaya?

Pass an Ouedkniss employment search URL for the desired location in startUrls.

Why did a run return no records?

The site may have blocked the request, changed its markup, or returned an empty search. Enable Apify Proxy and inspect the saved snapshot and STATS record.

Does it open every job page?

By default, yes. Set includeDetails to false for a faster card-level collection.

Can I schedule recurring monitoring?

Yes. Create an Apify schedule and set a suitable interval for the source and your use case.

Can I export the results?

Yes. Use the dataset view or Apify API to export JSON, CSV, Excel, or RSS-compatible feeds.

Support

For reproducible issues, include the run ID, input, STATS record, and the affected Ouedkniss URL when contacting the Actor author.