{
  "openapi": "3.0.1",
  "info": {
    "title": "Takealot Scraper - Products, Prices, Stock & Reviews",
    "description": "Scrape Takealot (takealot.com) South African marketplace products by keyword or URL. Extract prices, discounts, regional stock, ratings and customer reviews. Monitor Daily Deals and price drops with scheduled runs. Export structured data via JSON, CSV, Excel or API.",
    "version": "0.1",
    "x-build-id": "YYo7BUvFEOStGRnRq"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/abotapi~takealot-com-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-abotapi-takealot-com-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/abotapi~takealot-com-scraper/runs": {
      "post": {
        "operationId": "runs-sync-abotapi-takealot-com-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/abotapi~takealot-com-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-abotapi-takealot-com-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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "url"
            ],
            "type": "string",
            "description": "Search looks up products by keyword. URL mode reads specific takealot.com pages you paste (a product page, a search, the Daily Deals page).",
            "default": "search"
          },
          "queries": {
            "title": "Search keywords",
            "type": "array",
            "description": "Search mode: one or more keywords, for example 'laptop', 'air fryer', 'nappy bag'. Each keyword is its own walk; results are tagged with the keyword they came from.",
            "items": {
              "type": "string"
            }
          },
          "sort": {
            "title": "Sort order",
            "enum": [
              "Relevance",
              "Price Descending",
              "Price Ascending",
              "Rating Descending",
              "ReleaseDate Descending"
            ],
            "type": "string",
            "description": "How results are ordered: Relevance, Price Descending, Price Ascending, Rating Descending (Top Rated) or ReleaseDate Descending (Newest Arrivals).",
            "default": "Relevance"
          },
          "urls": {
            "title": "takealot.com links",
            "type": "array",
            "description": "URL mode: takealot.com pages to read, one per line (the mobile m. host works too). Product pages are read as single records; search, filter and Daily Deals pages are walked forward, with the link's own sort and filter applied. Department path pages are not supported and are skipped with a warning.",
            "default": [
              "https://www.takealot.com/deals?start=1",
              "https://www.takealot.com/all?search=laptop",
              "https://www.takealot.com/all?search=laptop&sort=Price%20Ascending&filter=Brand:Apple",
              "https://www.takealot.com/all?filter=Type:12&sort=Price%20Ascending&page=2",
              "https://www.takealot.com/apple-macbook-neo-13/PLID101174849"
            ],
            "items": {
              "type": "string"
            }
          },
          "brand": {
            "title": "Brand filter",
            "type": "string",
            "description": "Search mode: only products of this brand, for example Apple, Samsung or HP. Use the exact brand spelling the site uses."
          },
          "minPrice": {
            "title": "Min price (ZAR)",
            "minimum": 0,
            "type": "integer",
            "description": "Search mode: only products priced at or above this many rand."
          },
          "maxPrice": {
            "title": "Max price (ZAR)",
            "minimum": 0,
            "type": "integer",
            "description": "Search mode: only products priced at or below this many rand."
          },
          "minRating": {
            "title": "Minimum star rating",
            "enum": [
              "1",
              "2",
              "3",
              "4"
            ],
            "type": "string",
            "description": "Search mode: only products rated this many stars or better."
          },
          "inStockRegion": {
            "title": "In stock at",
            "enum": [
              "cpt",
              "dbn",
              "jhb"
            ],
            "type": "string",
            "description": "Search mode: only products in stock at the selected regional warehouse."
          },
          "dealType": {
            "title": "Deals filter",
            "enum": [
              "Featured Deals",
              "Bundle Deals",
              "TakealotMORE Deals"
            ],
            "type": "string",
            "description": "Search mode: only deal products. Featured Deals is the Daily Deals surface the homepage promotes; run it on a schedule to monitor price drops (each run reports what changed in incremental mode). Works with or without a keyword."
          },
          "fetchDetails": {
            "title": "Fetch product details",
            "type": "boolean",
            "description": "Read each product's own page to add the spec sheet, rich description, category chain, variant options, loyalty prices and offer detail. Adds a per-product surcharge (see the section caption below).",
            "default": true
          },
          "fetchReviews": {
            "title": "Fetch written reviews",
            "type": "boolean",
            "description": "With Fetch product details on, also read each product's written customer reviews (needs Fetch product details). Adds no extra surcharge beyond the detail one.",
            "default": false
          },
          "maxReviewsPerProduct": {
            "title": "Max reviews per product",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap on written reviews collected per product when Fetch written reviews is on (10 per page; at most 1000).",
            "default": 20
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stop after this many product records (0 = no limit; the run then stops when results run out). This is the only limit that stops a run early by default.",
            "default": 20
          },
          "maxPages": {
            "title": "Max pages per keyword",
            "minimum": 0,
            "type": "integer",
            "description": "Upper bound on pages walked per keyword or link. Defaults wide open so Max items is the only cap that stops a run early.",
            "default": 0
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify proxy settings for this run. The actor keeps a dedicated high-reliability connection pool of its own as the primary path and uses your selection alongside it, so the defaults just work. Datacenter-only connections are refused by the store's front door more often than residential ones."
          },
          "resumeFromRunId": {
            "title": "Resume from a previous run",
            "type": "string",
            "description": "Paste a previous run ID or dataset ID to continue a large pull without returning products already collected there."
          },
          "incrementalMode": {
            "title": "Incremental changes for scheduled runs",
            "type": "boolean",
            "description": "Turn this on for daily or recurring monitoring. The first run returns every matching product as NEW. Later runs return only NEW, UPDATED and REAPPEARED products. UPDATED means a compared field changed: price, price range, was-price, saving percent, stock flag and status, distribution centres, title, brand, ratings and review counts, badges, images, shipping text and every detail field; the scrape timestamp, product slug and estimated delivery text and type and any fields you list in Ignore fields are never compared (use What counts as a change to compare price and availability only). Turn on Emit unchanged or Emit expired only when you also want those rows returned (and billed). State is kept separately for each keyword, link and filter setup; use State key to name or deliberately share a monitoring campaign.",
            "default": false
          },
          "stateKey": {
            "title": "State key (optional, incremental mode only)",
            "type": "string",
            "description": "Optional. Name this monitoring campaign to keep its state stable, or deliberately share state across differently configured runs. Leave empty to let the actor derive a key automatically from the search, link and filter settings."
          },
          "emitUnchanged": {
            "title": "Emit unchanged records (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. Turn on to also return products that have not changed since the last run, marked UNCHANGED. This returns, and bills, extra rows you already have.",
            "default": false
          },
          "emitExpired": {
            "title": "Emit expired records (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. Turn on to also return products that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search.",
            "default": false
          },
          "changeScope": {
            "title": "What counts as a change (incremental mode only)",
            "enum": [
              "all",
              "priceAndStock"
            ],
            "type": "string",
            "description": "All fields (default): any change to the product record returns an UPDATED row, except the scrape timestamp, product slug and estimated delivery text and type and any names in Ignore fields. Price and availability only: only a change to price, price range, was-price (listingPrice), saving percent, in-stock flag, stock status or the distribution centres returns an UPDATED row; changes to titles, images, ratings, badges, descriptions or shipping text never do. Changing this option or the ignore list on a search with no State key starts a new baseline (use State key to keep one).",
            "default": "all"
          },
          "compactUpdates": {
            "title": "Compact update rows (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. When on, UPDATED and EXPIRED rows are short: product id, url, title, brand, current price and stock, plus priceChanges and variantChanges showing the old and new value of each moved price or stock field. NEW rows always carry the complete record. Detail fields and reviews are not in compact rows, so the per-product detail charge is not applied to them.",
            "default": false
          },
          "expireAfterMissedScans": {
            "title": "Expire after N missed full scans (incremental mode only)",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Only used with Emit expired records. A product is marked EXPIRED only after it has been missing from this many complete scans in a row (default 1). Raise it so a product that briefly drops out of a listing is not reported as gone. A product that comes back resets the count. EXPIRED means the product was no longer found in the scan, not that it is out of stock; stock is reported by inStock and stockStatus.",
            "default": 1
          },
          "ignoreFieldsForChanges": {
            "title": "Ignore fields when detecting changes (incremental mode only)",
            "type": "array",
            "description": "Optional. Field names to exclude from UPDATED change detection (the scrape timestamp, product slug and estimated delivery text and type are always excluded). Use it if a field in your setup is noisy. Dotted names such as ratingDistribution.star5 drop one key inside an object or each array element. Ignored fields stay in the output; they just never trigger UPDATED or appear in changedFields.",
            "items": {
              "type": "string"
            }
          },
          "mcpConnectors": {
            "title": "Pipe results into your apps (optional)",
            "type": "array",
            "description": "Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a rich page-per-item export; other connectors get a best-effort write or digest. Leave empty to skip; never changes the dataset output.",
            "items": {
              "type": "string"
            }
          },
          "notionParentPageUrl": {
            "title": "Notion parent page (Notion connector only)",
            "type": "string",
            "description": "URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors."
          },
          "maxNotifyListings": {
            "title": "Max items to export per connector",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap on items written to each connector per run. Does not affect the dataset.",
            "default": 50
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}