🚗 Ouedkniss Product Search Scraper

Extract structured product listings from Ouedkniss.com — Algeria's largest classifieds platform.

LICENSE

---

🚀 Getting Started with Apify

New to Apify? Create a free account with $5 credit — no credit card required.

1. Sign up — $5 platform credit included
2. Open this actor and configure your input
3. Click Start — export results as JSON, CSV, or Excel

Need more later? See Apify pricing.

---

📋 Overview

The Ouedkniss Product Search Scraper automates the collection of listings from Ouedkniss.com, converting category pages and search results into structured datasets perfect for market research, price monitoring, and data analysis.

✨ Key Features

Feature	Description
🔍 Search & Category Scraping	Scrape by URL or keyword — or both!
📦 Multi-URL Support	Process multiple categories in one run
📊 25+ Data Fields	Price, seller info, images, location, specs, and more
🔄 Pagination	Start from any page, scrape as many as you need
🛡️ Automatic Proxy Handling	Built-in proxy support (no setup required)
⚡ Resilient	Retry logic, deduplication, and graceful failure handling
🎯 Configurable Limits	Control exactly how many listings to collect

🚀 Quick Start

Minimal Configuration

{
  "urls": ["https://www.ouedkniss.com/automobiles_vehicules/"],
  "max_items_per_url": 10
}

Search Within a Category

{
  "urls": ["https://www.ouedkniss.com/automobiles_vehicules/"],
  "keyword": "Kia",
  "max_items_per_url": 50
}

Multiple Categories

{
  "urls": [
    "https://www.ouedkniss.com/automobiles_vehicules/",
    "https://www.ouedkniss.com/telephones_accessoires/",
    "https://www.ouedkniss.com/informatique/"
  ],
  "max_items_per_url": 100
}

📥 Input Fields

Field	Type	Default	Description
urls	array	—	Ouedkniss category or search-result URLs
keyword	string	""	Optional search term (e.g., "Kia", "iPhone")
page	integer	1	Starting page number
max_items_per_url	integer	20	Maximum listings per URL (1-10,000)
ignore_url_failures	boolean	true	Continue if one URL fails

📤 Output Data

Sample Listing

{
  "id": "54689639",
  "title": "Kia KX1 2025 ",
  "slug": "voitures-kia-kx1-2025-el-eulma-setif-algerie",
  "url": "https://www.ouedkniss.com/voitures-kia-kx1-2025-el-eulma-setif-algerie",
  "created_at": "2026-04-01T16:32:13.428950Z",
  "status": "PUBLISHED",
  "description": "كارت قريز",
  "price": null,
  "price_preview": 0,
  "price_unit": "MILLION",
  "price_type": null,
  "old_price": null,
  "old_price_preview": null,
  "exchange_type": null,
  "has_delivery": false,
  "is_from_store": true,
  "is_comment_enabled": true,
  "like_count": 0,
  "city_id": "711",
  "city": "El eulma",
  "city_slug": "el-eulma-711",
  "wilaya_id": "19",
  "wilaya": "Sétif",
  "wilaya_slug": "stif-19",
  "user_id": "14741576",
  "store_id": "37376",
  "store_name": "Ben hagga Auto",
  "store_slug": "ben-hagga-auto",
  "store_image": "https://cdn.ouedkniss.com/medias/images/Yv46BO/zJDkvUpUIZlhtLy7NmBoA54Oe9KRi0QZuvs9Yq4H.jpg",
  "store_is_official": false,
  "store_is_verified": false,
  "category_id": "606",
  "category_slug": "automobiles-voitures",
  "main_image": "https://cdn9.ouedkniss.com/medias/announcements/images/Yv46BO/DqUDOmKuftKrDnHK4qIIMWLQxQfksUWUB7lc427M.jpg",
  "all_images": [
    "https://cdn9.ouedkniss.com/medias/announcements/images/Yv46BO/DqUDOmKuftKrDnHK4qIIMWLQxQfksUWUB7lc427M.jpg",
    "https://cdn8.ouedkniss.com/medias/announcements/images/Yv46BO/0Q9rrnEYBLsDVLqhgFSIuUzwieYIWsGJijRHO63n.jpg",
    "https://cdn7.ouedkniss.com/medias/announcements/images/Yv46BO/OfpbhDOGXcSoA2krZUzfwQjHW317ScmQp6Qz9xbs.jpg",
    "https://cdn8.ouedkniss.com/medias/announcements/images/Yv46BO/6nuuuVVaYBtIWncjoFMxZYApqecWPWRdNzANGFU3.jpg",
    "https://cdn8.ouedkniss.com/medias/announcements/images/Yv46BO/ZYyhIhsXsSgSzpGF3Y1lIgOySCzjPQMo2HFaovrM.jpg",
    "https://cdn8.ouedkniss.com/medias/announcements/images/Yv46BO/Y5Ab0KS8jvtjwLQfv00G1ElhM8URsJSYbX3Y2RWm.jpg",
    "https://cdn7.ouedkniss.com/medias/announcements/images/Yv46BO/mAGPuCog4PI8svJqHyrCnNCznpLNoLp78VvxW7G1.jpg",
    "https://cdn7.ouedkniss.com/medias/announcements/images/Yv46BO/nVKde4KzFMqWWCMMGFGfTG8t9IIWNbaKSvEUcqRc.jpg",
    "https://cdn8.ouedkniss.com/medias/announcements/images/Yv46BO/EuaBRWLxd0X4zWTQmCc5lsvRGb6EC2faEeTl16l3.jpg",
    "https://cdn8.ouedkniss.com/medias/announcements/images/Yv46BO/fzFqQYdZljJxaKUhw3b5MPkX3BCExGYWJpEpUjRq.jpg",
    "https://cdn9.ouedkniss.com/medias/announcements/images/Yv46BO/aRYbjNmHAAKzxknirYB0VcMmkN6U9PlAbBPFkjgK.jpg",
    "https://cdn7.ouedkniss.com/medias/announcements/images/Yv46BO/KocXpKm12aZBiJQhstZRpmD4V16VpTc8Y220RqlY.jpg",
    "https://cdn9.ouedkniss.com/medias/announcements/images/Yv46BO/S9qbDN3gdLp0eTu1RQoJFJdPrkaNkmUaJ8xuzvvL.jpg"
  ]
}

All Output Fields

Specifications

When available, product specifications are automatically included as additional fields:

• spec_marque — Brand
• spec_modele — Model
• spec_annee — Year
• spec_kilometrage — Mileage

(Fields vary by category)

💰 Pricing & Usage

Collection Size	Estimated Credits	Best For
20 listings	Low	Quick testing
100 listings	Medium	Research samples
500+ listings	Higher	Full market analysis

💡 Tip: Start with a small test run (20 items) to verify your configuration before scaling up.

---

🎯 Use Cases

Use Case	Description
📊 Market Research	Study product availability, pricing trends, and market dynamics
💰 Price Monitoring	Track price changes across categories over time
🚗 Automotive Research	Analyze vehicle listings by brand, model, location, and specs
🛒 E-Commerce Intelligence	Compare seller activity, store performance, and product availability
📈 Data Aggregation	Build structured datasets for dashboards, analytics, and research

🛠️ How to Use

Step 1 — Find an Ouedkniss URL

Browse Ouedkniss and navigate to a category or search results page.

Example: https://www.ouedkniss.com/automobiles_vehicules/

Step 2 — Configure the Input

• URL: Paste your Ouedkniss URL
• Keyword: (Optional) Add a search term
• Max Items: Set your collection limit

Step 3 — Run the Actor

Start the run and wait for completion. The dataset will be available in the Output tab.

Step 4 — Export Your Data

Export the results as JSON, CSV, Excel, or via API.

---

🔧 Programmatic API Access

Run this Actor programmatically using the Apify API:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")

run_input = {
    "urls": ["https://www.ouedkniss.com/automobiles_vehicules/"],
    "keyword": "Kia",
    "max_items_per_url": 50
}

run = client.actor("your-username/ouedkniss-search-scraper").call(run_input=run_input)

# Get results
dataset_items = client.dataset(run["defaultDatasetId"]).list_items().items
for item in dataset_items:
    print(item["title"], item["price"])

❓ FAQ

📋 Recommended Settings

🧪 Small Test Run

{
  "urls": ["https://www.ouedkniss.com/automobiles_vehicules/"],
  "keyword": "Kia",
  "max_items_per_url": 20,
  "ignore_url_failures": true
}

📊 Medium Collection

{
  "urls": ["https://www.ouedkniss.com/immobilier/"],
  "max_items_per_url": 100,
  "ignore_url_failures": true
}

🏢 Multi-Category Research

{
  "urls": [
    "https://www.ouedkniss.com/automobiles_vehicules/",
    "https://www.ouedkniss.com/telephones_accessoires/",
    "https://www.ouedkniss.com/informatique/"
  ],
  "max_items_per_url": 100,
  "ignore_url_failures": true
}

📌 Important Notes

• ✅ Use category or search-result URLs (not individual listing pages)
• ✅ keyword is optional — leave empty to scrape the entire category
• ✅ Multiple URLs can be processed in a single run
• ✅ Start with a small test (20 items) before running large collections
• ✅ Enable ignore_url_failures for bulk collections
• ✅ Specifications fields vary by category

---

🔒 Privacy & Security

• No API keys required — just paste your URLs
• Your data is private — output datasets are only accessible to you
• Proxies are handled automatically — no setup needed

---

🔍 Search Keywords

ouedkniss scraper, ouedkniss api, apify ouedkniss, ouedkniss data extraction, algeria classifieds scraper, algeria marketplace data, ouedkniss product search, algeria e-commerce data, ouedkniss vehicle listings, algeria real estate scraper, ouedkniss apartments, ouedkniss cars, algeria price monitoring, ouedkniss data, ouedkniss jobs, algeria recruitment data, ouedkniss job listings

⚠️ Disclaimer

This actor accesses only publicly available data on Ouedkniss.com. You are responsible for how you use the extracted data — in particular any personal information such as names, phone numbers, or addresses — and for complying with Ouedkniss's terms of use, applicable data-protection law, and the anti-spam rules of your jurisdiction.

This actor is not affiliated with, endorsed by, or connected to Ouedkniss.com.

---

📞 Support

Having issues? Check the:

• FAQ section above
• Apify Documentation
• Contact the developer via Apify Console

---

📝 Changelog

[0.1.0] - 2026-08-24

Added:

• Initial release
• Category and keyword search support
• 25+ data fields per listing
• Multi-URL support
• Automatic proxy handling
• Pagination with configurable start page
• Deduplication of duplicate listings
• Retry logic for API stability
• ignore_url_failures option

---

📄 License

This Actor is provided for legitimate data collection and research purposes. Users are responsible for complying with Ouedkniss's terms of service.

---

Happy scraping! 🚀