# Ouedkniss Product Search Scraper (`stealth_mode/ouedkniss-product-search-scraper`) Actor Scrape product listings from Ouedkniss.com — Algeria's largest classifieds platform. Collect titles, prices, descriptions, media, seller info, delivery options, and 25+ fields per listing. Perfect for market research, price monitoring, and data aggregation. - **URL**: https://apify.com/stealth\_mode/ouedkniss-product-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Ouedkniss.com Product Search Scraper: Extract Listings at Scale --- ### What Is Ouedkniss.com? Ouedkniss.com is Algeria's most popular online classifieds marketplace, hosting millions of listings across categories including vehicles, real estate, electronics, and consumer goods. Whether you're tracking used car prices, monitoring competitor listings, or building a market intelligence dataset, manually collecting this volume of data is impractical. The **Ouedkniss Product Search Scraper** automates extraction from any category or search results page, delivering structured records ready for analysis. --- ### Overview The **Ouedkniss Search Scraper** turns category and search result pages into clean, structured datasets. It is built for: - **Market researchers** analyzing pricing trends across Algerian classifieds - **Automotive analysts** monitoring vehicle listings and price fluctuations - **E-commerce businesses** benchmarking competitor pricing and inventory - **Developers** feeding listing data into aggregator platforms or dashboards The scraper supports bulk URL input, configurable item limits, and fault-tolerant execution — skipping failed URLs without interrupting the run. --- ### Input Format ```json { "urls": ["https://www.ouedkniss.com/automobiles_vehicules/3"], "ignore_url_failures": true, "max_items_per_url": 50 } ```` | Field | Type | Description | |---|---|---| | `urls` | `array` | One or more Ouedkniss category or search result page URLs. Add individually or via bulk edit. Example: `https://www.ouedkniss.com/automobiles_vehicules/3` | | `ignore_url_failures` | `boolean` | If `true`, the scraper continues when a URL fails instead of stopping the entire run. Recommended for bulk jobs. Default: `true` | | `max_items_per_url` | `integer` | Maximum number of listings to collect per URL. Default: `20`. Increase for larger datasets (e.g., `50`, `100`). | > **Tip:** Use category-level URLs (e.g., `/automobiles_vehicules/3`) rather than individual listing pages — this scraper is designed for **search/listing pages**, not detail pages. *** ### Output Format ```json { "id": "55270708", "title": "Xiaomi Smart Camera C500 Double Objectif 8mp Original", "slug": "أمن-و-gps-xiaomi-smart-camera-c500-double-objectif-8mp-original-الأبيار-الجزائر", "created_at": "2026-05-14T11:04:59.000Z", "is_from_store": true, "is_comment_enabled": true, "has_delivery": false, "delivery_type": null, "payment_method": null, "like_count": 1, "description": "🏠 LİVRAİSON DISPONIBLE 58WILAYA\n💲PRİX : 23000DA PLUS FRAIS DE LIVRAISON\n❓POUR PLUS D'INFO VEULLIEZ NOUS CONTACTE SUR : ⬇️\n➡️ WHATSAP ➡️ VIBER ⬇️\n📞 +\n📞 +\n✅DESCRIPTION : ⬇️\n✅Caméra à double objectif avec détection intelligente par IA et qualité d'image améliorée\n✅Deux caméras, un seul appareil\n✅Un appareil unique, une couverture double\n✅Plusieurs modes de surveillance par IA\n✅Détection d'animaux\n✅Détection des pleurs de bébé\n✅Clôture virtuelle\n✅Suivi de personne\n✅Deux caméras connectées\n✅Suivi coordonné des personnes et écran partagé des deux caméras pour le visionnage et la lecture\n✅Angle de vision de la caméra fixe\n✅Angle de vision de la caméra PTZ (panoramique, inclinaison et zoom\n✅Double objectif 4 MP pour une qualité d'image ultra-HD\n✅5 objectifs optiques à haute transparence\n✅Double caméra pour une surveillance complète\n✅Deux caméras, un seul appareil. \n✅Couvre deux directions à la fois pour capturer simultanément deux vues d'intérieur et réduire les angles morts\n✅Deux caméras dans un seul appareil pour une couverture double\n✅Deux caméras, un seul appareil. ✅La caméra grand angle offre une vue d'ensemble, tandis que le téléobjectif fournit des gros plans détaillés, assurant ainsi une couverture complète\n✅Vision nocturne en couleur pour des en couleur plus longtemps\n✅Grâce au capteur d'image haute sensibilité intégré, la caméra s'adapte mieux aux environnements à faible luminosité et conserve les images en couleur pendant longtemps.", "status": "PUBLISHED", "cities": [ { "id": "584", "name": "الأبيار", "slug": "el-biar-584", "region": { "id": "16", "name": "الجزائر", "slug": "alger-16", "__typename": "Region" }, "__typename": "City" } ], "store": { "id": "27430", "name": "ALGEROİ SHOP ", "slug": "algeroi-shop", "image_url": "https://cdn.ouedkniss.com/medias/images/Z45k92/yfrGFI1tz7QicqI9FxFEh8rnsE40P96kUuACTgnl.jpg", "is_official": false, "is_verified": false, "view_as_store": true, "__typename": "Store" }, "user": { "id": "11065333", "__typename": "User" }, "default_media": { "media_url": "https://cdn9.ouedkniss.com/400/medias/announcements/images/Z45k92/jXJriNPAwzKUzlCdaeXuXBWRAF6r8Kd36Ya05LL3.jpg", "mime_type": "image/jpeg", "thumbnail": null, "__typename": "AnnouncementMedia" }, "medias": [ { "media_url": "https://cdn9.ouedkniss.com/200/medias/announcements/images/Z45k92/jXJriNPAwzKUzlCdaeXuXBWRAF6r8Kd36Ya05LL3.jpg", "mime_type": "image/jpeg", "thumbnail": null, "__typename": "AnnouncementMedia" }, { "media_url": "https://cdn8.ouedkniss.com/200/medias/announcements/images/Z45k92/U94f9nDli3of54DYXNBByD5ClFJW64tZepKUzQMp.jpg", "mime_type": "image/jpeg", "thumbnail": null, "__typename": "AnnouncementMedia" }, { "media_url": "https://cdn9.ouedkniss.com/200/medias/announcements/images/Z45k92/TJsbABFCZkslsBrZ3Dmzfd4q0KGTZ6vxJ4lvwv7C.jpg", "mime_type": "image/jpeg", "thumbnail": null, "__typename": "AnnouncementMedia" }, { "media_url": "https://cdn7.ouedkniss.com/200/medias/announcements/images/Z45k92/BpOjaU12GXC83g2oHSP6amG9oBaFFx6qEXEehUDb.jpg", "mime_type": "image/jpeg", "thumbnail": null, "__typename": "AnnouncementMedia" }, { "media_url": "https://cdn9.ouedkniss.com/200/medias/announcements/images/Z45k92/eysDynCouKBD1Vgho08OtDWZBQWKBXQDR3r74Ajk.jpg", "mime_type": "image/jpeg", "thumbnail": null, "__typename": "AnnouncementMedia" } ], "price": 23000, "price_preview": 23000, "price_unit": "UNIT", "old_price": null, "old_price_preview": null, "price_type": "FIXED", "exchange_type": "NOT_EXCHANGEABLE", "category": { "id": "166", "slug": "electronique-securite_gps", "delivery_type": "PRODUCT", "__typename": "Category" }, "small_description": [], "no_adsense": false } ``` Each listing returns up to 25+ fields: #### Identification & Metadata | Field | Meaning | |---|---| | `ID` | Unique internal Ouedkniss identifier for the listing | | `Title` | Listing title as shown on the platform | | `Slug` | URL-friendly identifier derived from the title | | `Created At` | Timestamp when the listing was published | | `Status` | Listing status (e.g., active, sold, expired) | | `Small Description` | Short teaser text shown in search results | | `Description` | Full listing description provided by the seller | #### Pricing | Field | Meaning | |---|---| | `Price` | Current asking price (numeric) | | `Price Preview` | Formatted price string for display (e.g., "150 000 DA") | | `Price Unit` | Currency or unit (e.g., DZD) | | `Old Price` | Previous price if a discount has been applied | | `Old Price Preview` | Formatted version of the old price | | `Price Type` | Whether the price is fixed, negotiable, or on exchange | | `Exchange Type` | Exchange conditions if the seller accepts trades | #### Seller & Store | Field | Meaning | |---|---| | `User` | Individual seller profile data | | `Store` | Store profile if the listing is from a merchant account | | `Is From Store` | Boolean flag — `true` if posted by a store, `false` for private sellers | #### Delivery & Payment | Field | Meaning | |---|---| | `Has Delivery` | Whether the seller offers delivery | | `Delivery Type` | Delivery method or service (e.g., local, national) | | `Payment Method` | Accepted payment options (e.g., cash, transfer) | #### Location | Field | Meaning | |---|---| | `Cities` | City or region where the listing is located | #### Media | Field | Meaning | |---|---| | `Default Media` | Primary listing image URL | | `Medias` | Array of all image URLs for the listing | #### Engagement & Flags | Field | Meaning | |---|---| | `Like Count` | Number of saves/likes the listing has received | | `Is Comment Enabled` | Whether buyers can comment on the listing | | `No Adsense` | Internal flag indicating ad-display behavior | | `Category` | Category and subcategory the listing belongs to | *** ### How to Use 1. **Find a category or search URL** on Ouedkniss.com (e.g., browse to Vehicles → copy the page URL). 2. **Paste into `urls`** — add multiple URLs for parallel collection across categories. 3. **Set `max_items_per_url`** based on your dataset size needs. 4. **Enable `ignore_url_failures: true`** for resilient bulk runs. 5. **Run and export** — download results as JSON, CSV, or Excel. **Common issues:** - Ensure URLs point to **listing/search pages**, not individual product detail pages. - If results are empty, verify the URL loads correctly in a browser before adding it. - For large categories, increase `max_items_per_url` gradually and monitor run time. *** ### Use Cases & Business Value - **Automotive market analysis:** Track make/model pricing trends across Algerian used car listings - **Price monitoring:** Set up recurring runs to detect price drops or new listings - **Inventory research:** Understand supply levels across product categories - **Academic/economic research:** Study informal marketplace dynamics in North Africa *** ### Conclusion The **Ouedkniss Product Search Scraper** unlocks structured access to one of North Africa's most active classifieds platforms. With 25+ fields per listing and flexible configuration, it removes the manual burden of data collection and turns Ouedkniss search pages into production-ready datasets. Start a run on any category and have clean, structured data within minutes. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## `proxy` (type: `object`): Select proxies to be used by your scraper. ## Actor input object example ```json { "urls": [ "https://www.ouedkniss.com/automobiles_vehicules/3" ], "ignore_url_failures": true, "max_items_per_url": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://www.ouedkniss.com/automobiles_vehicules/3" ], "ignore_url_failures": true, "max_items_per_url": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/ouedkniss-product-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": ["https://www.ouedkniss.com/automobiles_vehicules/3"], "ignore_url_failures": True, "max_items_per_url": 20, "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/ouedkniss-product-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "https://www.ouedkniss.com/automobiles_vehicules/3" ], "ignore_url_failures": true, "max_items_per_url": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call stealth_mode/ouedkniss-product-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/ouedkniss-product-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Ouedkniss Product Search Scraper", "description": "Scrape product listings from Ouedkniss.com — Algeria's largest classifieds platform. Collect titles, prices, descriptions, media, seller info, delivery options, and 25+ fields per listing. Perfect for market research, price monitoring, and data aggregation.", "version": "0.0", "x-build-id": "XtDzJzSEFDePc7fxU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~ouedkniss-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-ouedkniss-product-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/stealth_mode~ouedkniss-product-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-ouedkniss-product-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/stealth_mode~ouedkniss-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-ouedkniss-product-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "URLs of the product search list urls to scrape", "type": "array", "description": "Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your scraper." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```