# Takealot Products Scraper 🛍️ (`shahidirfan/takealot-products-scraper`) Actor Extract live product data from Takealot instantly. Get prices, titles, descriptions, ratings, stock status & seller info. Perfect for price tracking, competitor analysis, market research, retail analytics & dynamic pricing. South Africa's premier e-commerce platform. ETL-ready. - **URL**: https://apify.com/shahidirfan/takealot-products-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** E-commerce, Developer tools, Automation - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Takealot Products Scraper Extract Takealot product listings from category pages and search results with a clean, structured dataset. Collect pricing, ratings, availability, delivery signals, and product links in a format that is ready for research, monitoring, and catalog building. ### Features - **Category URL support** - Start from Takealot category pages such as Automotive, Home, Beauty, and more - **Keyword search support** - Search Takealot directly when you do not want to supply a URL - **Cursor pagination** - Collect multiple pages of results while respecting your limits - **Clean dataset output** - Excludes null-only fields and keeps only useful product data - **Marketplace-ready fields** - Includes pricing, review metrics, stock status, delivery messaging, and product links ### Use Cases #### Product Research Build datasets of product listings for sourcing, assortment planning, and competitor discovery. Compare brands, price points, and availability across relevant categories. #### Price Monitoring Track displayed prices, discount messaging, and delivery availability over time. Use repeated runs to watch changes in product offers and ranges. #### Catalog Enrichment Collect product identifiers, titles, brands, review counts, and product links for downstream enrichment in spreadsheets, databases, or BI tools. #### Keyword Discovery Search for terms such as accessories, brands, or product types to see what Takealot currently returns and how products are positioned. ### Input Parameters | Parameter | Type | Required | Default | Description | | -------------------- | ------- | -------- | ---------------------------------------------------------------- | --------------------------------------------- | | `url` | String | No | `https://www.takealot.com/automotive/interior-accessories-25850` | A Takealot category URL or search results URL | | `keyword` | String | No | `car phone holder` | Search term used when no URL is supplied | | `results_wanted` | Integer | No | `20` | Maximum number of products to save | | `max_pages` | Integer | No | `5` | Maximum number of result pages to request | | `proxyConfiguration` | Object | No | `{"useApifyProxy": false}` | Optional Apify proxy settings | ### Output Data Each item in the dataset contains: | Field | Type | Description | | ---------------------------- | ------- | ------------------------------------------------------------- | | `product_id` | Integer | Takealot product identifier | | `offer_product_id` | Integer | Offer-level product identifier when available | | `tsin` | Integer | Takealot TSIN identifier | | `title` | String | Product title | | `subtitle` | String | Product subtitle when available | | `brand` | String | Product brand | | `slug` | String | Product slug | | `product_url` | String | Takealot product page URL | | `pretty_price` | String | Displayed price text | | `current_price` | Number | Primary numeric price | | `price_min` | Number | Lowest price returned for the listing | | `price_max` | Number | Highest price returned for the listing | | `list_price` | Number | Displayed list price when available | | `prices` | Array | Numeric prices returned for the listing | | `saving` | String | Discount or savings text | | `currency` | String | Currency code | | `rating` | Number | Average rating | | `review_count` | Integer | Number of reviews | | `badges` | Array | Badge labels such as discount messaging | | `image_url` | String | Main product image URL | | `image_gallery_urls` | Array | Full image gallery URLs returned in the same listing response | | `image_count` | Integer | Number of images | | `has_more_colours` | Boolean | Whether more colour variants are available | | `add_to_cart_available` | Boolean | Whether direct add-to-cart is available | | `shop_all_options_available` | Boolean | Whether multiple options are available | | `availability_status` | String | Stock or lead-time message | | `is_in_stock` | Boolean | In-stock flag | | `is_leadtime` | Boolean | Lead-time flag | | `is_imported` | Boolean | Imported flag | | `estimated_delivery` | String | Delivery estimate text | | `estimated_delivery_type` | String | Delivery estimate type | | `distribution_centres` | Array | Distribution centre codes | | `department_slug` | String | Department slug for category runs | | `category_slug` | String | Category slug for category runs | | `search_term` | String | Search term for keyword runs | | `sort` | String | Current sort mode | | `source_url` | String | Original listing URL used for the run | | `page` | Integer | Result page number | | `page_position` | Integer | Product position within the page | | `overall_position` | Integer | Product position within the full run | | `page_cursor` | String | Cursor used to request the current page | ### Usage Examples #### Category Extraction ```json { "url": "https://www.takealot.com/automotive/interior-accessories-25850", "results_wanted": 50, "max_pages": 3 } ```` #### Keyword Search ```json { "keyword": "car phone holder", "results_wanted": 30, "max_pages": 2 } ``` #### Continue From a Cursor URL ```json { "url": "https://www.takealot.com/automotive/interior-accessories-25850?after=WzIuMSw5MzIzNTE4MV0", "results_wanted": 36, "max_pages": 2 } ``` ### Sample Output ```json { "product_id": 96995951, "offer_product_id": 220683055, "tsin": 98205352, "title": "3-Piece Universal Car Rubber Mats Set Trimmable to Fit All Cars", "slug": "3-piece-universal-car-rubber-mats-set-trimmable-to-fit-all-cars", "product_url": "https://www.takealot.com/3-piece-universal-car-rubber-mats-set-trimmable-to-fit-all-cars/PLID96995951", "pretty_price": "R 219", "current_price": 219, "price_min": 219, "price_max": 219, "list_price": 297, "prices": [219], "saving": "26% off", "currency": "ZAR", "rating": 4.5, "review_count": 171, "badges": ["26% off"], "image_url": "https://media.takealot.com/covers_images/b5dfe19431b24deeab278a3ea9e1d626/s-zoom.file", "image_gallery_urls": [ "https://media.takealot.com/covers_images/b5dfe19431b24deeab278a3ea9e1d626/s-zoom.file", "https://media.takealot.com/covers_images/0a2e2ea5c38d474c9f83f431ce64aebc/s-zoom.file" ], "image_count": 5, "add_to_cart_available": true, "availability_status": "In stock", "is_in_stock": true, "estimated_delivery": "Get it Tomorrow, 8am - 7pm", "estimated_delivery_type": "next_day", "distribution_centres": ["JHB"], "department_slug": "automotive", "category_slug": "interior-accessories-25850", "sort": "Relevance", "source_url": "https://www.takealot.com/automotive/interior-accessories-25850", "page": 1, "page_position": 1, "overall_position": 1 } ``` ### Tips for Best Results #### Use Real Listing Pages - Start with a working Takealot category page or search URL - Use direct product listing pages rather than individual product pages - Keep the URL in the same format that Takealot exposes in the browser #### Keep Test Runs Small - Start with `results_wanted: 20` for quick validation - Increase `max_pages` only when you need deeper pagination - Use smaller runs first when testing new keywords #### Prefer Specific Keywords - Broad keywords may return mixed categories - Product-type keywords usually produce cleaner datasets - Use category URLs when you need strict category coverage ### Proxy Configuration Residential or datacenter proxies can be enabled when needed: ```json { "proxyConfiguration": { "useApifyProxy": true } } ``` ### Integrations - **Google Sheets** - Export product data for analysis - **Airtable** - Build searchable product tables - **Make** - Trigger automated workflows from fresh runs - **Zapier** - Forward product data into business tools - **Webhooks** - Deliver results into custom systems #### Export Formats - **JSON** - For APIs and developers - **CSV** - For spreadsheets and quick analysis - **Excel** - For business reporting - **XML** - For system integrations # Actor input Schema ## `url` (type: `string`): A Takealot listing URL such as a category, department, brand, tag, or search results page. Tracking parameters are ignored automatically. ## `keyword` (type: `string`): Use this when you want to search Takealot without supplying a URL. ## `results_wanted` (type: `integer`): Maximum number of products to save. ## `max_pages` (type: `integer`): Maximum number of result pages to request. ## `proxyConfiguration` (type: `object`): Optional proxy configuration for Apify runs. ## Actor input object example ```json { "url": "https://www.takealot.com/automotive/interior-accessories-25850", "results_wanted": 20, "max_pages": 3, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 = { "url": "https://www.takealot.com/automotive/interior-accessories-25850", "results_wanted": 20, "max_pages": 3 }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/takealot-products-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 = { "url": "https://www.takealot.com/automotive/interior-accessories-25850", "results_wanted": 20, "max_pages": 3, } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/takealot-products-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 '{ "url": "https://www.takealot.com/automotive/interior-accessories-25850", "results_wanted": 20, "max_pages": 3 }' | apify call shahidirfan/takealot-products-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/takealot-products-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Takealot Products Scraper 🛍️", "description": "Extract live product data from Takealot instantly. Get prices, titles, descriptions, ratings, stock status & seller info. Perfect for price tracking, competitor analysis, market research, retail analytics & dynamic pricing. South Africa's premier e-commerce platform. ETL-ready.", "version": "0.0", "x-build-id": "j9I60tDiSHbj3glNP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~takealot-products-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-takealot-products-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/shahidirfan~takealot-products-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-takealot-products-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/shahidirfan~takealot-products-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-takealot-products-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": { "url": { "title": "Takealot URL", "type": "string", "description": "A Takealot listing URL such as a category, department, brand, tag, or search results page. Tracking parameters are ignored automatically." }, "keyword": { "title": "Keyword", "type": "string", "description": "Use this when you want to search Takealot without supplying a URL." }, "results_wanted": { "title": "Results wanted", "minimum": 1, "type": "integer", "description": "Maximum number of products to save.", "default": 20 }, "max_pages": { "title": "Max pages", "minimum": 1, "type": "integer", "description": "Maximum number of result pages to request.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy configuration for Apify runs.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```