{
  "openapi": "3.0.1",
  "info": {
    "title": "Njuškalo Scraper — Croatia Classifieds",
    "description": "Scrape vehicle and product listings from Njuškalo.hr, Croatia's largest classifieds marketplace. Extract prices, descriptions, seller info, location, and photos. Covers cars, real estate, electronics, and more. Essential for Croatian market data.",
    "version": "0.7",
    "x-build-id": "CV6evCPIfoIootyym"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/rastriq~njuskalo-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-rastriq-njuskalo-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/rastriq~njuskalo-scraper/runs": {
      "post": {
        "operationId": "runs-sync-rastriq-njuskalo-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/rastriq~njuskalo-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-rastriq-njuskalo-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": {
          "data_freshness": {
            "title": "📡 Data Source",
            "enum": [
              "live",
              "preloaded"
            ],
            "type": "string",
            "description": "<p>Choose <strong>Live</strong> to scrape Njuškalo in real time. Choose <strong>Preloaded</strong> for instant access to our pre-scraped monthly snapshot at lower cost.</p>",
            "default": "live"
          },
          "categories": {
            "title": "🏗️ Categories",
            "type": "array",
            "description": "<p>Select which equipment categories to scrape. Default selection covers industrial machinery and commercial vehicles (Cyclica/Tesya scope).</p>",
            "items": {
              "type": "string",
              "enum": [
                "mini-bageri",
                "bageri-gusjenicari",
                "bageri-na-kotacima",
                "buldozeri",
                "demperi",
                "utovarivaci",
                "grederi",
                "kranovi",
                "vibro-ploce-vibro-nabijaci",
                "valjci",
                "drobilice-separacije",
                "finiseri",
                "ostali-gradevinski-strojevi",
                "gradjevina-ostalo",
                "gradevinski-prikljucak",
                "radne-platforme",
                "visinski-radovi-oprema",
                "gradevinska-mehanizacija",
                "traktori",
                "traktori-gume",
                "traktori-motor-dijelovi",
                "traktori-vuca",
                "traktori-prijenos-snage",
                "traktori-karoserija-kabina",
                "traktori-ovjes-kocnice",
                "traktori-elektronika",
                "traktori-rasvjeta",
                "traktori-felge",
                "traktori-tekucine",
                "traktori-ostalo",
                "dijelovi-traktore",
                "dijelovi-za-traktore",
                "kombajni",
                "dijelovi-za-kombajne",
                "dijelovi-kombajne",
                "strojevi-obrada-tla",
                "obrada-tla",
                "dijelovi-obrada-tla",
                "oprema-obrada-tla",
                "strojevi-sjetva-zetva-berba",
                "oprema-sjetva-zetva-berba",
                "dijelovi-sjetva-zetva-berba",
                "sjetva-zetva-berba",
                "strojevi-gnojidba-navodnjavanje",
                "oprema-gnojidba-navodnjavanje",
                "dijelovi-gnojidba-navodnjavanje",
                "zastita-gnojidba-navodnjavanje",
                "strojevi-gospodarstvo",
                "oprema-transport-pretovar",
                "transport-pretovar",
                "traktor-kosilica",
                "stocarstvo",
                "vocnjak-oprema",
                "poljoprivreda-ostalo",
                "poljoprivredni-rucni-alati",
                "stroj-obrada-metala",
                "strojevi-obrada-metala",
                "oprema-obrada-metala",
                "alati-obrada-metala",
                "ostali-obradni-alati",
                "strojevi-obrada-drva",
                "strojevi-obrada-drveta",
                "oprema-obrada-drva",
                "alati-obrada-drva",
                "kombinirke",
                "ostali-obradni-strojevi",
                "obradni-strojevi-ostalo",
                "ceoni-vilicari",
                "regalni-vilicari",
                "rucni-vilicari",
                "vilicari-oprema",
                "platforme",
                "komunalni-strojevi",
                "komunalni-strojevi-dijelovi",
                "komunalni-strojevi-prikljucak",
                "komunalni-alati",
                "komunalna-oprema",
                "sumski-strojevi",
                "sumarstvo-strojevi-dijelovi",
                "sumarstvo-oprema",
                "sumarstvo-strojevi-oprema",
                "motorne-pile",
                "mjerni-instrumenti",
                "motorne-kosilice",
                "elektricne-kosilice",
                "aku-kosilice",
                "robotske-kosilice",
                "kosilice-dodaci",
                "motorni-trimeri",
                "aku-trimeri",
                "elektricni-trimeri",
                "trimeri-dodaci",
                "aku-skare",
                "elektricne-skare",
                "rucne-skare",
                "motorne-skare",
                "puhac-lisce",
                "vrtna-oprema",
                "vrtni-alat",
                "vrtni-alat-ostalo",
                "dostavna-vozila",
                "mali-kamioni",
                "kamioni-kiperi",
                "kamioni-tegljaci",
                "kamioni-hladnjace",
                "kamioni-cisterne",
                "kamioni-mikseri",
                "kamioni-ostalo",
                "poluprikolice",
                "kamionske-prikolice",
                "autobusi",
                "autobusi-kombi",
                "ostala-gospodarska-vozila",
                "pumpe-kompresori",
                "kompresori",
                "elektromotori-agregati",
                "moto-agregati",
                "strojevi-ciscenje",
                "oprema-ciscenje",
                "strojevi-transport-tereta",
                "dijelovi-transport-tereta",
                "strojevi-alati-ostalo",
                "rucni-strojevi-alati",
                "rucni-alati",
                "alati-ostalo"
              ],
              "enumTitles": [
                "Mini Bageri",
                "Bageri Gusjenicari",
                "Bageri Na Kotacima",
                "Buldozeri",
                "Demperi",
                "Utovarivaci",
                "Grederi",
                "Kranovi",
                "Vibro Ploce Vibro Nabijaci",
                "Valjci",
                "Drobilice Separacije",
                "Finiseri",
                "Ostali Gradevinski Strojevi",
                "Gradjevina Ostalo",
                "Gradevinski Prikljucak",
                "Radne Platforme",
                "Visinski Radovi Oprema",
                "Gradevinska Mehanizacija",
                "Traktori",
                "Traktori Gume",
                "Traktori Motor Dijelovi",
                "Traktori Vuca",
                "Traktori Prijenos Snage",
                "Traktori Karoserija Kabina",
                "Traktori Ovjes Kocnice",
                "Traktori Elektronika",
                "Traktori Rasvjeta",
                "Traktori Felge",
                "Traktori Tekucine",
                "Traktori Ostalo",
                "Dijelovi Traktore",
                "Dijelovi Za Traktore",
                "Kombajni",
                "Dijelovi Za Kombajne",
                "Dijelovi Kombajne",
                "Strojevi Obrada Tla",
                "Obrada Tla",
                "Dijelovi Obrada Tla",
                "Oprema Obrada Tla",
                "Strojevi Sjetva Zetva Berba",
                "Oprema Sjetva Zetva Berba",
                "Dijelovi Sjetva Zetva Berba",
                "Sjetva Zetva Berba",
                "Strojevi Gnojidba Navodnjavanje",
                "Oprema Gnojidba Navodnjavanje",
                "Dijelovi Gnojidba Navodnjavanje",
                "Zastita Gnojidba Navodnjavanje",
                "Strojevi Gospodarstvo",
                "Oprema Transport Pretovar",
                "Transport Pretovar",
                "Traktor Kosilica",
                "Stocarstvo",
                "Vocnjak Oprema",
                "Poljoprivreda Ostalo",
                "Poljoprivredni Rucni Alati",
                "Stroj Obrada Metala",
                "Strojevi Obrada Metala",
                "Oprema Obrada Metala",
                "Alati Obrada Metala",
                "Ostali Obradni Alati",
                "Strojevi Obrada Drva",
                "Strojevi Obrada Drveta",
                "Oprema Obrada Drva",
                "Alati Obrada Drva",
                "Kombinirke",
                "Ostali Obradni Strojevi",
                "Obradni Strojevi Ostalo",
                "Ceoni Vilicari",
                "Regalni Vilicari",
                "Rucni Vilicari",
                "Vilicari Oprema",
                "Platforme",
                "Komunalni Strojevi",
                "Komunalni Strojevi Dijelovi",
                "Komunalni Strojevi Prikljucak",
                "Komunalni Alati",
                "Komunalna Oprema",
                "Sumski Strojevi",
                "Sumarstvo Strojevi Dijelovi",
                "Sumarstvo Oprema",
                "Sumarstvo Strojevi Oprema",
                "Motorne Pile",
                "Mjerni Instrumenti",
                "Motorne Kosilice",
                "Elektricne Kosilice",
                "Aku Kosilice",
                "Robotske Kosilice",
                "Kosilice Dodaci",
                "Motorni Trimeri",
                "Aku Trimeri",
                "Elektricni Trimeri",
                "Trimeri Dodaci",
                "Aku Skare",
                "Elektricne Skare",
                "Rucne Skare",
                "Motorne Skare",
                "Puhac Lisce",
                "Vrtna Oprema",
                "Vrtni Alat",
                "Vrtni Alat Ostalo",
                "Dostavna Vozila",
                "Mali Kamioni",
                "Kamioni Kiperi",
                "Kamioni Tegljaci",
                "Kamioni Hladnjace",
                "Kamioni Cisterne",
                "Kamioni Mikseri",
                "Kamioni Ostalo",
                "Poluprikolice",
                "Kamionske Prikolice",
                "Autobusi",
                "Autobusi Kombi",
                "Ostala Gospodarska Vozila",
                "Pumpe Kompresori",
                "Kompresori",
                "Elektromotori Agregati",
                "Moto Agregati",
                "Strojevi Ciscenje",
                "Oprema Ciscenje",
                "Strojevi Transport Tereta",
                "Dijelovi Transport Tereta",
                "Strojevi Alati Ostalo",
                "Rucni Strojevi Alati",
                "Rucni Alati",
                "Alati Ostalo"
              ]
            }
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 0,
            "maximum": 500000,
            "type": "integer",
            "description": "<p>Total result cap across all categories. Set <strong>0</strong> for unlimited.</p>",
            "default": 0
          },
          "maxPages": {
            "title": "Max pages / category",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "<p>~25 listings per page. Set <strong>0</strong> for unlimited (scrape entire category).</p>",
            "default": 0
          },
          "scrapeDetail": {
            "title": "Scrape detail (description, specs, phone, images)",
            "type": "boolean",
            "description": "<p>Fetch each ad's HTML page for full description, technical specs, phone number, and HD images. <strong>Slower</strong> — requires DECODO_PROXY env var. Recommended for smaller runs (&lt;5K items).</p>",
            "default": false
          },
          "maxConcurrent": {
            "title": "Concurrent categories",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Number of categories to scrape in parallel.",
            "default": 3
          },
          "outputSchema": {
            "title": "📋 Output schema",
            "enum": [
              "english",
              "ftp28"
            ],
            "type": "string",
            "description": "<p>Select 'ftp28' to output canonical Spanish field names for FTP-28 pipeline integration.</p>",
            "default": "english"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}