🇩🇿 Ouedkniss Scraper

Want Ouedkniss classified ads in a spreadsheet? This scraper makes it easy.

Use structured filters — better for AI agents — or paste an input_url. When input_url is set it overrides the filters.

Ouedkniss is Algeria’s main classifieds site. Cars & Vehicles alone is about 280,000 ads. This actor returns up to 2000 rows per run.

💡 Perfect for...

• Marketplaces: Export cars, property, electronics, and jobs from Ouedkniss.
• Dashboards: Track new ads without paging the site.
• Market research: Slice Algerian classifieds by category, wilaya, seller, or car make.
• Data analysts: Export structured rows with public listing URLs.
• 🤖 AI Agents: Power Claude, Cursor, Codex, the Hermes Agent, and OpenClaw workflows with live Ouedkniss results.
• 📚 RAG Systems: Feed titles, prices, and cities into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste an Ouedkniss category or search URL, or pick the same filters as the site. input_url always wins when set.
• 🎯 Website-Matched Filters: Category, keyword, wilaya, price range, seller, delivery, exchange, photos, price present, car make, fuel, year, and sort.
• 🌐 Listing cards: Title, price, city, wilaya, seller, fuel, mileage, and listing URL.

📦 What's inside the data?

id, url, title, price, price_unit, city, region, category, category_slug, seller, fuel, mileage, transmission, engine, image_url, created_at, refreshed_at

🚀 Quick start

Option A: paste https://www.ouedkniss.com/automobiles_vehicules/alger/1. Option B: pick a category, wilaya, or car make and set max_results.

Input Example (filters):

{
  "category": "automobiles_vehicules",
  "region": "alger",
  "make": "renault",
  "max_results": 100
}

Input Example (URL):

{
  "input_url": "https://www.ouedkniss.com/immobilier/1",
  "max_results": 100
}

Output Example:

{
  "id": "56863268",
  "url": "https://www.ouedkniss.com/cars-livan-x3-pro-2026-automatique-avec-toi-ouvrant-dely-brahim-alger-algeria-d56863268",
  "title": "Livan X3 Pro 2026 Automatique",
  "price": 3650000,
  "price_unit": "MILLION",
  "city": "Dely Ibrahim",
  "region": "Alger",
  "category": "Cars",
  "category_slug": "automobiles-voitures",
  "seller": "Private seller",
  "fuel": "Essence",
  "mileage": "0 km",
  "transmission": "Automatique",
  "engine": "1.5",
  "image_url": "https://cdn8.ouedkniss.com/400/medias/announcements/images/example.jpg",
  "created_at": "2026-07-30T16:18:07.197761Z",
  "refreshed_at": "2026-09-03T17:00:57.000Z"
}

Output fields:

Field	Description
id	Ouedkniss ad id.
url	Public listing page.
title	Ad title.
price	Price in Algerian dinars when shown.
price_unit	Price unit when shown.
city	City names on the ad.
region	Wilaya names on the ad.
category	Category label.
category_slug	Category path on the site.
seller	Private seller or store.
fuel	Fuel type when shown (cars).
mileage	Mileage when shown (cars).
transmission	Gearbox when shown (cars).
engine	Engine size when shown (cars).
image_url	Listing photo.
created_at	When the ad was created.
refreshed_at	When the ad was last refreshed.

📋 Input reference

Parameter	Type	Required	Default	Description
input_url	string	No	—	Ouedkniss category or search URL. Overrides every filter.
category	string enum	No	Cars & Vehicles	Same categories as the homepage menu.
query	string	No	—	Same as the site search box.
region	string enum	No	all	Algerian wilaya.
price_min	integer	No	—	Lowest price in Algerian dinars.
price_max	integer	No	—	Highest price in Algerian dinars.
origin	string enum	No	anyone	Private seller or store.
delivery	boolean	No	false	Only ads that offer delivery.
exchange	boolean	No	false	Only ads that accept an exchange.
has_pictures	boolean	No	false	Only ads with photos.
has_price	boolean	No	false	Only ads that show a price.
make	string enum	No	all	Car brand. Used for Cars & Vehicles.
fuel	string enum	No	any	Petrol, diesel, LPG, hybrid, or electric. Used for Cars & Vehicles.
year	integer	No	—	Exact model year for cars.
sort	string enum	No	refreshed	Recently refreshed or newest first.
max_results	integer	No	50	Maximum rows (1–2000).