{
  "openapi": "3.0.1",
  "info": {
    "title": "Bazoš Scraper & New Ad Monitor: CZ, SK, PL, AT",
    "description": "Scrape Bazoš.cz, Bazoš.sk, Bazos.pl and Bazos.at: every section, any search URL. Watch a search for new and cheaper ads with alerts to Telegram, Slack or Discord, deal score vs. similar ads, car fields, full details. Unofficial.",
    "version": "0.0",
    "x-build-id": "YKxdazzseOM0xuRZe"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~bazos-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-bazos-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/tsutseisoftware~bazos-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-bazos-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/tsutseisoftware~bazos-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-bazos-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": "Bazoš URLs",
            "type": "array",
            "description": "Any listing from bazos.cz, bazos.sk, bazos.pl or bazos.at: a section (https://auto.bazos.cz/), a category (https://mobil.bazos.cz/apple/), a search with words, postal code, radius and price (set it on the website and paste the address of the results) or the search of all sections. Also ad URLs (https://auto.bazos.cz/inzerat/<number>/<name>.php): an ad URL is read with its whole description and photos and charged as an ad with \"Ad page read\". A listing is always read from its first page.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "searchQueries": {
            "title": "Search words",
            "type": "array",
            "description": "Words to search, e.g. \"iphone 15\", \"octavia combi\", \"lednice\". Each is a separate search in every section chosen below (or in all sections when none is chosen). Combined with the postal code, radius and price below. Leave empty to read whole sections.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "enum": [
              "cz",
              "sk",
              "pl",
              "at"
            ],
            "type": "string",
            "description": "The Bazoš website of the searches built from \"Search words\" and \"Sections\" (pasted URLs keep their own country).",
            "default": "cz"
          },
          "sections": {
            "title": "Sections",
            "type": "array",
            "description": "Sections of the website to search or read. Empty with search words = all sections.",
            "items": {
              "type": "string",
              "enum": [
                "cars",
                "motorbikes",
                "phones",
                "computers",
                "electronics",
                "photo",
                "homeGarden",
                "furniture",
                "kids",
                "clothes",
                "sport",
                "music",
                "books",
                "machinery",
                "tickets",
                "animals",
                "realEstate",
                "jobs",
                "services",
                "other"
              ],
              "enumTitles": [
                "Cars (Auto)",
                "Motorbikes (Motorky)",
                "Phones (Mobily)",
                "Computers (PC)",
                "Electronics (Elektro)",
                "Photo (Foto)",
                "Home & garden (Dům a zahrada)",
                "Furniture (Nábytek)",
                "Kids (Děti)",
                "Clothes (Oblečení)",
                "Sport",
                "Music (Hudba)",
                "Books (Knihy)",
                "Machinery & tools (Stroje)",
                "Tickets (Vstupenky)",
                "Animals (Zvířata)",
                "Real estate (Reality)",
                "Jobs (Práce)",
                "Services (Služby)",
                "Other (Ostatní)"
              ]
            }
          },
          "postalCode": {
            "title": "Postal code",
            "type": "string",
            "description": "Search around this postal code (PSČ), e.g. 11000 for Prague 1, 60200 for Brno, 81101 for Bratislava, 00950 for Warsaw, 1010 for Vienna. Empty = the whole country."
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "With \"Postal code\": how far around it.",
            "default": 25
          },
          "minPrice": {
            "title": "Price from",
            "minimum": 0,
            "type": "integer",
            "description": "The website's price filter, in the currency of the country (CZK, EUR, PLN). Ads without a number as their price (\"Dohodou\", \"V textu\") are left out by the website when a price is set."
          },
          "maxPrice": {
            "title": "Price to",
            "minimum": 0,
            "type": "integer",
            "description": "The website's price filter, in the currency of the country."
          },
          "maxItems": {
            "title": "Max ads",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of ads saved. You pay per saved ad. 0 = no limit.",
            "default": 100
          },
          "maxPages": {
            "title": "Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Read at most this many pages (40 ads each) of every search. 0 = no limit.",
            "default": 0
          },
          "includeDetails": {
            "title": "Add ad page details",
            "type": "boolean",
            "description": "Open each ad page to add its whole description (e-mails and phone numbers removed), every photo, the category and the map point of the postal code. Extra charge \"Ad page read\" per saved ad whose page was read (see the Pricing tab). Off: data of the listing pages (title, start of the description, price, place, views, date, TOP, first photo).",
            "default": false
          },
          "includeVehicleFields": {
            "title": "Add vehicle fields (cars and motorbikes)",
            "type": "boolean",
            "description": "For ads of the Cars and Motorbikes sections: make, year, mileage (km), power (kW), engine size (ccm), fuel and gearbox, read from the title and the description (Bazoš has no form fields for them, so they are filled only where the seller wrote them clearly; with \"Add ad page details\" the whole description is used and far more fields are found). Charged as \"Vehicle fields\" per saved ad with at least one field found (see the Pricing tab).",
            "default": false
          },
          "includeItemFields": {
            "title": "Add item fields (phones, computers, electronics, photo)",
            "type": "boolean",
            "description": "For ads of the Phones, Computers, Electronics and Photo sections: brand, model, storage (GB), RAM, battery health (%), condition (new, like new, used, for parts) and warranty, read from the title and the description (filled only where the seller wrote them clearly; with \"Add ad page details\" the whole description is used). Charged as \"Item fields\" per saved ad with at least one field found (see the Pricing tab).",
            "default": false
          },
          "includePriceHistory": {
            "title": "Add price history",
            "type": "boolean",
            "description": "Every run remembers the prices it saw (in a key-value store of your account, per Monitoring key), and every ad gets its price history: changes, lowest and highest price of 30 and 90 days, average, whether the price is the lowest in 90 days, and the list of changes. The history starts with your first run; schedule the same search. Prices of older ads are seen only when the run reads them, so with monitoring turn \"read only new ads\" off. Charged as \"Price history\" per saved ad whose history goes back before the run (see the Pricing tab).",
            "default": false
          },
          "includeDealScore": {
            "title": "Deal score",
            "type": "boolean",
            "description": "Compare the price of every ad with the median price of comparable ads (same item, not its accessories): comparableCount, comparableMedianPrice, priceVsMedianPercent and dealScore (0-100, 50 = the usual price, higher = cheaper). Free. A score needs a few comparable ads, so it works best with bigger searches.",
            "default": true
          },
          "titleKeywords": {
            "title": "Title must contain",
            "type": "array",
            "description": "Keep only ads whose title contains at least one of these texts (case and diacritics don't matter).",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Must not contain",
            "type": "array",
            "description": "Skip ads whose title or description contains any of these texts, e.g. \"vadný\", \"na díly\", \"kryt\".",
            "items": {
              "type": "string"
            }
          },
          "skipTopAds": {
            "title": "Skip TOP ads",
            "type": "boolean",
            "description": "Skip ads promoted with the website's paid TOP mark (they stay on top of every listing, often for weeks).",
            "default": false
          },
          "skipWantedAds": {
            "title": "Skip \"wanted\" ads",
            "type": "boolean",
            "description": "Skip ads of people who buy instead of selling (\"Koupím…\", \"Sháním…\", \"Hledám…\", \"Kúpim…\", \"Kupię…\", \"Suche…\"). Every row has isWanted either way.",
            "default": false
          },
          "onlyWithPrice": {
            "title": "Only ads with a price",
            "type": "boolean",
            "description": "Skip ads without a number as their price (\"Dohodou\", \"V textu\", \"Zdarma\").",
            "default": false
          },
          "postedWithinDays": {
            "title": "Posted in the last N days",
            "minimum": 0,
            "type": "integer",
            "description": "Only ads posted or renewed in the last N days. A listing in the website's order (newest first) is read only until the older ads begin. 0 = any time."
          },
          "minDealScore": {
            "title": "Min deal score",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Keep only ads with at least this deal score (e.g. 60 = about 20 % below the median of comparable ads). Ads without enough comparable ads are left out."
          },
          "maxPriceVsMedianPercent": {
            "title": "Max price vs. median (%)",
            "type": "integer",
            "description": "Keep only ads whose price is at most this many percent above (or, negative, below) the median of comparable ads, e.g. -15. Ads without enough comparable ads are left out."
          },
          "priceCheckQueries": {
            "title": "Price check: items",
            "type": "array",
            "description": "Items to price, e.g. \"iPhone 13 128GB\", \"PS5 digital\", \"Octavia combi 2016\". An ad matches when its title has every word of the item and no accessory words (kryt, obal, sklo…). Asking prices of current ads, not prices of sales.",
            "items": {
              "type": "string"
            }
          },
          "priceCheckPages": {
            "title": "Price check: pages per item",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Listing pages (40 ads each) read for every item. More pages = more ads in the statistics.",
            "default": 2
          },
          "onlyNewOrChanged": {
            "title": "Monitoring: only new or changed ads",
            "type": "boolean",
            "description": "Return only ads that are new or whose title or price changed since the previous run with the same Monitoring key (changed ads have previousPrice, priceChange and priceChangePercent). Every listing page read in this mode is charged as \"Monitoring: listing page checked\" (see the Pricing tab; one page = 40 ads).",
            "default": false
          },
          "monitoringKey": {
            "title": "Monitoring: key",
            "type": "string",
            "description": "Name of the saved state. Use a different key for each watched search (e.g. \"iphone-praha\"). Empty = a key derived from the searches and ad URLs of the run, so different searches never share a state. The value is stored encrypted."
          },
          "stopAtKnownAds": {
            "title": "Monitoring: read only new ads",
            "type": "boolean",
            "description": "After the first run, find the ads posted since the last check and read only those, so a check stays cheap. Bazoš shows every TOP ad first (often hundreds of them), so new ads are far down the listing and reading its first pages would miss them; this mode finds them anyway. The first run reads the listing as usual. Off = read the whole search every run (finds price changes of older ads too). Turned off by \"include removed\" and \"include unchanged\". With more than 50 new ads between two checks the status message says so: run more often.",
            "default": true
          },
          "includeRemovedAds": {
            "title": "Monitoring: include removed (sold) ads",
            "type": "boolean",
            "description": "Also return ads of the previous run that are no longer in the search (sold or deleted), as rows with changeType \"removed\" (and \"reappeared\" when they come back), with daysOnline. Needs the whole search read every run; checked only when the run read every search completely. Charged like any other ad.",
            "default": false
          },
          "includeUnchanged": {
            "title": "Monitoring: include unchanged ads",
            "type": "boolean",
            "description": "Also return the ads that did not change, as rows with changeType \"unchanged\" (charged like any other ad).",
            "default": false
          },
          "skipReposts": {
            "title": "Monitoring: skip reposted ads",
            "type": "boolean",
            "description": "Do not return a new ad when the seller posted an ad of an earlier run again under another ID. Off = such ads are returned with isRepost true and repostOf.",
            "default": false
          },
          "includeMarketReport": {
            "title": "Monitoring: market report",
            "type": "boolean",
            "description": "With monitoring: every run writes MARKET_REPORT to the key-value store: per section and category the ads on sale and their median price, the ads that disappeared in the last 30 days (sold, or deleted by the seller) with their median last price, median days to sell, share sold within 7 days and the sell-through rate. It learns from the ads that disappear between your runs, so it reads the whole search every run (like \"include removed\") and gets better with every run. Charged once per run as \"Market report\" (see the Pricing tab).",
            "default": false
          },
          "slackWebhookUrl": {
            "title": "Notifications: Slack webhook URL",
            "type": "string",
            "description": "Incoming webhook of your Slack channel (https://hooks.slack.com/services/...). Stored encrypted."
          },
          "discordWebhookUrl": {
            "title": "Notifications: Discord webhook URL",
            "type": "string",
            "description": "Webhook of your Discord channel (https://discord.com/api/webhooks/...). In Discord: channel settings → Integrations → Webhooks → Copy Webhook URL. Stored encrypted."
          },
          "telegramBotToken": {
            "title": "Notifications: Telegram bot token",
            "type": "string",
            "description": "Token of your Telegram bot (from @BotFather). Used with \"Telegram chat ID\". Stored encrypted."
          },
          "telegramChatId": {
            "title": "Notifications: Telegram chat ID",
            "type": "string",
            "description": "Chat, group or channel ID the bot writes to (e.g. -1001234567890)."
          },
          "webhookUrl": {
            "title": "Notifications: webhook URL",
            "type": "string",
            "description": "Any HTTPS URL (Zapier, Make, n8n, your server): gets a POST with JSON {title, summary, totalSaved, runUrl, datasetUrl, items}."
          },
          "whatsappAccessToken": {
            "title": "Notifications: WhatsApp access token",
            "type": "string",
            "description": "Access token of the WhatsApp Cloud API of your Meta business account, used with \"WhatsApp phone number ID\" and \"WhatsApp recipient number\" (step by step in the README, section \"WhatsApp notifications: setup\"). For scheduled runs use a permanent token of a system user: Business settings → System users → Generate token, with the permissions whatsapp_business_messaging and whatsapp_business_management; the token of WhatsApp → API Setup expires within hours. Stored encrypted."
          },
          "whatsappPhoneNumberId": {
            "title": "Notifications: WhatsApp phone number ID",
            "type": "string",
            "description": "ID of your WhatsApp business number that sends the message (not the number itself), e.g. 106540352242922. In your Meta app: WhatsApp → API Setup → Phone number ID."
          },
          "whatsappTo": {
            "title": "Notifications: WhatsApp recipient number",
            "type": "string",
            "description": "Phone number that gets the message, in international format with the country code (e.g. +420601234567); up to 5 numbers separated by commas or new lines, each gets its own message and the notification is charged once per run. A test number of Meta sends only to numbers you added and confirmed under API Setup → To. Stored encrypted."
          },
          "whatsappTemplateName": {
            "title": "Notifications: WhatsApp template name",
            "type": "string",
            "description": "Name of your approved message template (WhatsApp Manager → Message templates, e.g. apify_results), recommended: WhatsApp delivers a template message at any time. Its body gets the run summary with the first results in {{1}} and the dataset link in {{2}} (a template with only {{1}} gets both in {{1}}). Empty: a plain text message, which WhatsApp delivers only when the recipient wrote to your business number in the last 24 hours, so a scheduled run usually needs a template. Meta charges your business account for template messages (step by step in the README, section \"WhatsApp notifications: setup\")."
          },
          "whatsappTemplateLanguage": {
            "title": "Notifications: WhatsApp template language",
            "type": "string",
            "description": "Language code of the template exactly as WhatsApp Manager → Message templates shows it next to the template, e.g. en_US, en_GB, cs, sk, pl or de. Used only with \"WhatsApp template name\".",
            "default": "en_US"
          },
          "notificationLimit": {
            "title": "Notifications: max ads per message",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many ads are listed in one notification (the rest as \"…and N more\").",
            "default": 10
          },
          "notifyOnlyChanges": {
            "title": "Notifications: only when something was saved",
            "type": "boolean",
            "description": "Send nothing when the run saved no ad (e.g. a monitoring run without new ads).",
            "default": true
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Keep only the core fields of every row: id, title, price, place, section, category, date, TOP, views, photo, deal score, link (and the monitoring and vehicle fields).",
            "default": false
          },
          "excludeEmptyFields": {
            "title": "Leave out empty fields",
            "type": "boolean",
            "description": "Drop fields that are null or an empty list from every row (id, source, url, adId, title and scrapedAt always stay).",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "No proxy needed. Turn a proxy on only if the website starts rejecting requests.",
            "default": {
              "useApifyProxy": false
            }
          },
          "sendErrorReports": {
            "title": "Send error reports",
            "type": "boolean",
            "description": "When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}