{
  "openapi": "3.0.1",
  "info": {
    "title": "Altex.ro Product Scraper: Prices, Stock, Specs & Reviews",
    "description": "Scrape altex.ro products by category, search, product link, SKUs or the whole catalogue. Get prices and promotions, open-box deals, stock per store, sellers, specifications, ratings and reviews: up to 103 fields per product. Filter by brand, price and stock. Unofficial, not affiliated with Altex.",
    "version": "0.1",
    "x-build-id": "pec2Jqt9sPScWhhH2"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/extractify-labs~altex-ro-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-extractify-labs-altex-ro-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/extractify-labs~altex-ro-scraper/runs": {
      "post": {
        "operationId": "runs-sync-extractify-labs-altex-ro-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/extractify-labs~altex-ro-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-extractify-labs-altex-ro-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": {
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "altex.ro links to scrape: categories (…/cpl/, filtered category links too), searches (…/cauta/?q=…) and products (…/cpd/SKU/). The type of each link is detected for you. Links to other sites or to promo pages are skipped. Leave everything empty to scrape 50 phones.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Words to search for on altex.ro, as you would type them, for example \"frigider no frost\". At least 3 characters. Each term returns up to 720 products, the most the site shows.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "skus": {
            "title": "SKUs",
            "type": "array",
            "description": "Altex product codes to scrape, one per line, for example from an earlier run's `sku` field. Fastest way to re-check prices and stock of products you already know.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "allProducts": {
            "title": "Whole catalogue",
            "type": "boolean",
            "description": "Scrape every product on altex.ro (more than 590,000). Start URLs, search terms, SKUs and filters are ignored when this is on. Use Max products to stop early.",
            "default": false
          },
          "maxItems": {
            "title": "Max products",
            "minimum": 0,
            "type": "integer",
            "description": "How many products to collect in this run, across all sources. 0 means no limit. A list-only run collects thousands of products per minute; with product details, about 6,000 per hour.",
            "default": 50
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Only products of these brands, as named on altex.ro, for example \"Samsung\" or \"De'Longhi\". A product matches if it has any of them. Applies to categories and searches.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minPrice": {
            "title": "Minimum price (RON)",
            "minimum": 0,
            "type": "integer",
            "description": "Only products at or above this price, in lei, VAT included. Applies to categories and searches."
          },
          "maxPrice": {
            "title": "Maximum price (RON)",
            "minimum": 0,
            "type": "integer",
            "description": "Only products at or below this price, in lei, VAT included. Applies to categories and searches."
          },
          "availability": {
            "title": "Availability",
            "enum": [
              "any",
              "in_stock",
              "supplier_stock",
              "preorder"
            ],
            "type": "string",
            "description": "Only products with this stock status. Applies to categories and searches. \"In stock at the supplier\" works on categories only.",
            "default": "any"
          },
          "promotion": {
            "title": "Promotions",
            "enum": [
              "any",
              "promotion",
              "super_price",
              "promotion_or_super_price"
            ],
            "type": "string",
            "description": "Only products on promotion, only SUPER PRET products, or either. Applies to categories and searches.",
            "default": "any"
          },
          "minRating": {
            "title": "Minimum rating",
            "enum": [
              "any",
              "1",
              "2",
              "3",
              "4",
              "5"
            ],
            "type": "string",
            "description": "Only products rated at least this many stars. Applies to categories and searches.",
            "default": "any"
          },
          "newArrivalsOnly": {
            "title": "New arrivals only",
            "type": "boolean",
            "description": "Only products altex.ro marks as new. Applies to categories and searches.",
            "default": false
          },
          "withOpenBoxOnly": {
            "title": "With open-box units only",
            "type": "boolean",
            "description": "Only products that also have open-box (resigilate) units on offer. Applies to categories and searches.",
            "default": false
          },
          "soldByAltexOnly": {
            "title": "Sold by Altex only",
            "type": "boolean",
            "description": "Skip marketplace sellers and keep products sold by Altex itself. Works on categories only.",
            "default": false
          },
          "sellerIds": {
            "title": "Sellers",
            "type": "array",
            "description": "Only products offered by these sellers, by seller ID, one per line (1 is Altex). You find seller IDs in an earlier run's `sellerId` and `sellerIds` fields. Together with Sold by Altex only, products of Altex or of these sellers are kept. Works on categories only.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "storeIds": {
            "title": "In stock at stores",
            "type": "array",
            "description": "Only products in stock at these Altex stores, by store ID, one per line. You find store IDs in an earlier run's `stockStoreIds` field or in Stock in each store. A product matches if any of the stores has it. Works on categories only.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "recommended",
              "price_asc",
              "price_desc",
              "name_asc",
              "name_desc",
              "best_deal",
              "most_reviewed"
            ],
            "type": "string",
            "description": "The order products are collected in, which matters when Max products stops the run early. Search supports only Recommended, Price and Name. Categories with about 10,000 products or more are collected in price order when you ask for more than that.",
            "default": "recommended"
          },
          "includeProductDetails": {
            "title": "Product details",
            "type": "boolean",
            "description": "Adds every seller offer, the full gallery, grouped specifications, descriptions, warranty, manufacturer details, category path, open-box units and the star breakdown. About 10 minutes per 1,000 products. Same price per product.",
            "default": false
          },
          "includeStoreAvailability": {
            "title": "Stock in each store",
            "type": "boolean",
            "description": "Adds the stock of each product in every Altex store (store, city, county, quantity, store manager and phone). About one extra request per product. Same price per product.",
            "default": false
          },
          "includeShippingOptions": {
            "title": "Delivery options",
            "type": "boolean",
            "description": "Adds the delivery methods, carriers, delivery times and fees for the city below. About one extra request per product. Same price per product.",
            "default": false
          },
          "shippingCity": {
            "title": "Delivery city",
            "type": "string",
            "description": "The city to get delivery options for, as written on altex.ro, without diacritics. Used only with Delivery options.",
            "default": "Bucuresti"
          },
          "shippingRegion": {
            "title": "Delivery county",
            "type": "string",
            "description": "The county (județ) of the delivery city, without diacritics, for example \"Bucuresti\" or \"Cluj\". Used only with Delivery options.",
            "default": "Bucuresti"
          },
          "includeReviews": {
            "title": "Reviews",
            "type": "boolean",
            "description": "Adds customer reviews with their texts, ratings, dates and photos. Fetched once per product family. Same price per product.",
            "default": false
          },
          "maxReviewsPerProduct": {
            "title": "Max reviews per product",
            "minimum": 1,
            "type": "integer",
            "description": "How many reviews to collect for each product. Used only with Reviews.",
            "default": 20
          },
          "includeQuestions": {
            "title": "Questions and answers",
            "type": "boolean",
            "description": "Adds customer questions with their answers. Fetched once per product family. Same price per product.",
            "default": false
          },
          "maxQuestionsPerProduct": {
            "title": "Max questions per product",
            "minimum": 1,
            "type": "integer",
            "description": "How many questions to collect for each product. Used only with Questions and answers.",
            "default": 20
          },
          "includeProductPageExtras": {
            "title": "Product-page extras",
            "type": "boolean",
            "description": "Adds the return window and item condition from the public product page. The slowest option, about one product per second. Same price per product.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "No proxy is needed, and none is used by default. If your runs are refused, switch on Apify Proxy (datacenter). Residential proxies and your own proxy URLs are not supported.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}