# 2ememain Search Scraper (`stealth_mode/2ememain-search-scraper`) Actor Scrape search results from 2ememain.be and 2dehands.be — Belgium's largest classifieds platforms. Collect titles, prices, locations, seller info, images, and 25+ structured fields per listing. Perfect for market research, price monitoring, and lead generation. - **URL**: https://apify.com/stealth\_mode/2ememain-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## 2ememain.be Search Scraper: Extract Marketplace Listings at Scale --- ### What Is 2ememain.be? 2ememain.be (French) and its Dutch counterpart 2dehands.be form Belgium's dominant second-hand and classifieds marketplace, covering categories from vehicles and real estate to electronics and fashion. With thousands of new listings posted daily, manually tracking prices, availability, or seller patterns is impractical. The **2ememain.be Search Scraper** automates collection across any search or category page, delivering clean, structured data ready for analysis. --- ### Overview This scraper targets **search and category listing pages** on 2ememain.be and 2dehands.be, extracting every visible item on each page up to your configured limit. It is suited for: - **Price analysts** monitoring used car or real estate market trends - **Resellers** tracking competitor listings and inventory - **Lead generators** collecting seller contact data (where available) - **Data scientists** building training datasets from classified ads - **Businesses** benchmarking product pricing across the Belgian market --- ### Input Format ```json { "urls": [ "https://www.2ememain.be/l/autos/p/2/#Language:all-languages" ], "ignore_url_failures": true, "max_items_per_url": 50 } ```` | Field | Type | Description | |---|---|---| | `urls` | `array` of strings | One or more search/category page URLs to scrape. Supports pagination URLs (e.g., `/p/2/`, `/p/3/`). Add URLs one by one or via bulk edit. | | `ignore_url_failures` | `boolean` | If `true`, the scraper continues running 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`. Set higher (e.g., `50`) to capture full pages. | > **Tip:** To scrape multiple pages of the same category, add each paginated URL separately (e.g., `/p/1/`, `/p/2/`, `/p/3/`). Use the same search filters in the URL to ensure consistent results. *** ### Output Format #### Sample Output ```json { "item_id": "m2335649230", "title": "Audi Q7 TFSI 60 E Competition 3,0 l V6 (462 ch) quattro", "description": "Belle audi q7 quattro 462 ch ! ! ! 05/10/23 Date de première inscription en flandre: taxes d'immersion : 46,23€ uniquement et 467,59€ de taxe de circulation annuelle jantes 23 inch marqu", "category_specific_description": "Belle audi q7 quattro 462 ch ! ! ! 05/10/23 Date de première inscription en flandre: taxes d'immersion : 46,23€ uniquement et 467,59€ de taxe de circulation annuelle jantes 23 inch marque concaver inserts en carbone haut-parleurs bang &...", "thin_content": false, "price_info": { "price_cents": 6950000, "price_type": "MIN_BID", "suppress_zero_cents": true }, "location": { "city_name": "Geel", "country_name": "Belgique", "country_abbreviation": "BE", "distance_meters": -1000, "is_buyer_location": false, "on_country_level": false, "abroad": false, "latitude": 51.166471415842, "longitude": 4.9847355570556 }, "date": "Aujourd'hui", "image_urls": [ "//images.2dehands.com/api/v1/hz-twh-pro-listing/images/411f8231-4de5-43c7-84a9-0cbcdd977aad?rule=ecg_mp_eps$_82.jpg" ], "seller_information": { "seller_id": 28803315, "seller_name": "falzone fabrice", "show_soi_url": true, "show_website_url": false, "is_verified": false }, "category_id": 93, "priority_product": "NONE", "video_on_vip": false, "urgency_feature_active": false, "nap_available": false, "attributes": [ { "key": "constructionYear", "value": "2023", "values": [ "2023" ] }, { "key": "mileage", "value": "39000", "unit": "km", "values": [ "39000" ] }, { "key": "fuel", "value": "Hybride Électrique/Essence", "values": [ "Hybride Électrique/Essence" ] }, { "key": "transmission", "value": "Automatique", "values": [ "Automatique" ] }, { "key": "body", "value": "SUV ou Tout-terrain", "values": [ "SUV ou Tout-terrain" ] }, { "key": "model", "value": "Q7", "values": [ "Q7" ] }, { "key": "options", "value": "Sièges chauffants", "values": [ "Sièges chauffants" ] }, { "key": "priceType", "value": "Achat", "values": [ "Achat" ] } ], "extended_attributes": [ { "key": "priceType", "value": "Achat", "values": [ "Achat" ] }, { "key": "interiorcolor", "value": "Noir", "values": [ "Noir" ] }, { "key": "aantaldeurenBE", "value": "5 portes", "values": [ "5 portes" ] }, { "key": "driveTrain", "value": "Quatre roues motrices / 4X4", "values": [ "Quatre roues motrices / 4X4" ] } ], "traits": [ "PACKAGE_PREMIUM" ], "verticals": [ "cars", "audi", "automotive" ], "pictures": [ { "id": 0, "media_id": "", "url": "https://images.2dehands.com/api/v1/hz-twh-pro-listing/images/411f8231-4de5-43c7-84a9-0cbcdd977aad?rule=ecg_mp_eps$_#.jpg", "extra_small_url": "https://images.2dehands.com/api/v1/hz-twh-pro-listing/images/411f8231-4de5-43c7-84a9-0cbcdd977aad?rule=ecg_mp_eps$_14.jpg", "medium_url": "https://images.2dehands.com/api/v1/hz-twh-pro-listing/images/411f8231-4de5-43c7-84a9-0cbcdd977aad?rule=ecg_mp_eps$_82.jpg", "large_url": "https://images.2dehands.com/api/v1/hz-twh-pro-listing/images/411f8231-4de5-43c7-84a9-0cbcdd977aad?rule=ecg_mp_eps$_83.jpg", "extra_extra_large_url": "https://images.2dehands.com/api/v1/hz-twh-pro-listing/images/411f8231-4de5-43c7-84a9-0cbcdd977aad?rule=ecg_mp_eps$_85.jpg", "aspect_ratio": { "width": 3, "height": 4 } } ], "search_type": "TokenMatch", "reserved": false, "vip_url": "/v/autos/audi/m2335649230-audi-q7-tfsi-60-e-competition-3-0-l-v6-462-ch-quattro", "short_title": "Audi Q7", "display_title": "TFSI 60 E Competition 3,0 l V6 (462 ch) quattro" } ``` Each listing returns a structured record with 25+ fields: #### Core Listing Info | Field | Meaning | |---|---| | `Item ID` | Unique internal identifier for the listing | | `Title` | Full listing title as displayed in search results | | `Short Title` | Abbreviated title used in compact views | | `Display Title` | Formatted title optimized for the platform UI | | `Description` | Full listing description text | | `Category Specific Description` | Additional description fields specific to the category (e.g., vehicle specs) | | `Thin Content` | Flag indicating whether the listing has minimal content | | `VIP URL` | Direct URL to the full listing detail page | #### Pricing & Location | Field | Meaning | |---|---| | `Price Info` | Price object including amount, currency, and price type (fixed, negotiable, free, etc.) | | `Location` | Seller's city or region as entered on the listing | | `Date` | Listing publication or last-updated date | #### Media | Field | Meaning | |---|---| | `Image URLs` | Array of image URLs attached to the listing | | `Pictures` | Extended picture metadata including thumbnails and full-resolution paths | | `Video On VIP` | Whether a video is embedded on the listing detail page | #### Seller & Contact | Field | Meaning | |---|---| | `Seller Information` | Seller name, type (private/professional), and profile link | | `NAP Available` | Whether Name, Address, and Phone data is accessible for the seller | #### Category & Classification | Field | Meaning | |---|---| | `Category ID` | Internal numeric ID of the listing's category | | `Attributes` | Standard structured attributes (e.g., make, model, year for vehicles) | | `Extended Attributes` | Additional category-specific key-value pairs | | `Traits` | Platform-side tags describing listing characteristics | | `Verticals` | Market vertical classification (e.g., motors, real estate, jobs) | | `Search Type` | How the item appears in results (organic, promoted, etc.) | #### Listing Flags | Field | Meaning | |---|---| | `Priority Product` | Whether the listing has paid priority placement | | `Urgency Feature Active` | Whether the seller has activated an urgency badge ("Sell fast") | | `Reserved` | Whether the item has been marked as reserved by the seller | *** ### How to Use 1. **Get the search URL** — Perform a search or browse a category on 2ememain.be. Copy the URL including any active filters (price range, location, language, etc.). 2. **Add pagination if needed** — Append `/p/2/`, `/p/3/` etc. to scrape multiple result pages. 3. **Configure the input** — Paste URLs into the `urls` array and set `max_items_per_url` to match the page's listing count (typically 30–50). 4. **Run and export** — Start the scraper and download results as JSON, CSV, or Excel. **Best practices:** - Keep `ignore_url_failures: true` for any multi-URL run. - Filter by category in the URL (e.g., `/l/autos/`) to get cleaner, more consistent `Attributes` output. - For price monitoring, schedule recurring runs and compare `Price Info` over time. *** ### Use Cases & Business Value - **Used car market analysis:** Track average prices, mileage ranges, and seller types across Belgian automotive listings - **Inventory monitoring:** Watch for new listings in a niche category as they appear - **Competitive intelligence:** Benchmark your own listings against similar items - **Lead generation:** Identify professional sellers via `Seller Information` and `NAP Available` - **Academic research:** Study second-hand market dynamics and consumer behavior in Belgium *** ### Conclusion The **2ememain.be Search Scraper** gives you programmatic access to one of Belgium's busiest classifieds platforms. With 25+ structured output fields and flexible URL-based configuration, it covers everything from bulk price research to targeted listing monitoring — without any manual copy-pasting. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the 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. ## Actor input object example ```json { "urls": [ "https://www.2ememain.be/l/autos/p/2/#Language:all-languages" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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.2ememain.be/l/autos/p/2/#Language:all-languages" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/2ememain-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.2ememain.be/l/autos/p/2/#Language:all-languages"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/2ememain-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.2ememain.be/l/autos/p/2/#Language:all-languages" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/2ememain-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/2ememain-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "2ememain Search Scraper", "description": "Scrape search results from 2ememain.be and 2dehands.be — Belgium's largest classifieds platforms. Collect titles, prices, locations, seller info, images, and 25+ structured fields per listing. Perfect for market research, price monitoring, and lead generation.", "version": "0.0", "x-build-id": "P933oeDMyTQiJWhxs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~2ememain-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-2ememain-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~2ememain-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-2ememain-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~2ememain-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-2ememain-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 search list urls to scrape", "type": "array", "description": "Add the URLs of the 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." } } }, "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 } } } } } } } } } } ```