{
  "openapi": "3.0.1",
  "info": {
    "title": "Jumbo Argentina Scraper: Grocery Prices, Stock & Catalog API",
    "description": "Scrape Jumbo Argentina (Cencosud) grocery prices, discounts and stock from the supermarket catalog. Get product name, brand, price and list price in pesos (ARS), EAN barcode, per unit price, installments, seller and category. Filter by search, category, price or URL. Export JSON, CSV, Excel.",
    "version": "0.1",
    "x-build-id": "GttW0Ol2QxEsHxd3C"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapers_lat~jumbo-ar-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapers_lat-jumbo-ar-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/scrapers_lat~jumbo-ar-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapers_lat-jumbo-ar-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/scrapers_lat~jumbo-ar-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapers_lat-jumbo-ar-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": {
          "maxProducts": {
            "title": "Max products",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Maximum number of product offers to collect across all search terms and categories. Each available SKU and seller is one record. Optional."
          },
          "withDetails": {
            "title": "Include Product Details",
            "type": "boolean",
            "description": "When enabled, each record also includes the product description and specification attributes (content, package size, product type, etc.) from the Jumbo catalog.",
            "default": true
          },
          "searchTerms": {
            "title": "Search Terms",
            "type": "array",
            "description": "Full-text queries to search the Jumbo Argentina catalog (e.g. \"leche\", \"yerba mate\", \"coca cola\"). Each term is searched separately. Maps to the VTEX ft parameter.",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Restrict results to one or more Jumbo departments. Use either a numeric VTEX category id or a category path. Top-level department ids: 1 Almacén, 2 Bebidas, 3 Frutas y Verduras, 4 Carnes, 5 Pescados y Mariscos, 6 Quesos y Fiambres, 7 Lácteos, 8 Congelados, 9 Panaderia y Pasteleria, 10 Rotiseria, 11 Perfumería, 13 Limpieza, 14 Mascotas, 15 Electro, 16 Hogar y textil, 457 Mundo Bebe, 465 Tiempo Libre. Paths look like \"Lácteos/Leches\". Maps to the VTEX fq=C: filter.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Product & search URLs",
            "type": "array",
            "description": "Paste Jumbo Argentina URLs to scrape directly: product pages (ending in /p), search result pages, or category pages. Each product URL returns that exact product; each search/category URL is crawled like a query. Combine with search terms and categories.",
            "items": {
              "type": "string"
            }
          },
          "minPrice": {
            "title": "Minimum price (ARS)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return offers with a current price greater than or equal to this amount in Argentine pesos. Optional."
          },
          "maxPrice": {
            "title": "Maximum price (ARS)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return offers with a current price less than or equal to this amount in Argentine pesos. Optional."
          },
          "onlyAvailable": {
            "title": "Only in-stock offers",
            "type": "boolean",
            "description": "When enabled, drop out-of-stock offers and return only products that are currently available.",
            "default": false
          },
          "onlyOnSale": {
            "title": "Only discounted offers",
            "type": "boolean",
            "description": "When enabled, return only offers that carry a real markdown (current price below the list/reference price).",
            "default": false
          },
          "sortOrder": {
            "title": "Sort Order",
            "enum": [
              "",
              "OrderByPriceASC",
              "OrderByPriceDESC",
              "OrderByTopSaleDESC",
              "OrderByNameASC",
              "OrderByNameDESC",
              "OrderByReleaseDateDESC",
              "OrderByBestDiscountDESC"
            ],
            "type": "string",
            "description": "Order in which the catalog returns products. Maps to the VTEX O parameter.",
            "default": ""
          },
          "withAiDescription": {
            "title": "AI product description (paid add-on)",
            "type": "boolean",
            "description": "Off by default. When on, writes a clean English marketing description of each product. Requires a paid Apify plan. Billed only when a description is produced.",
            "default": false
          },
          "withAiAttributes": {
            "title": "AI attributes extraction (paid add-on)",
            "type": "boolean",
            "description": "Off by default. When on, extracts structured attributes (category, package size, unit count, flavor/variant, dietary tags) from each product. Requires a paid Apify plan. Billed only when attributes are produced.",
            "default": false
          },
          "withAiTranslate": {
            "title": "AI translate to English (paid add-on)",
            "type": "boolean",
            "description": "Off by default. When on, translates each product name and description from Spanish to English. Requires a paid Apify plan. Billed only when a translation is produced.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}