{
  "openapi": "3.0.1",
  "info": {
    "title": "Kleinanzeigen Scraper ($1.37/1K): New Ad Monitor & Deals",
    "description": "Scrape Kleinanzeigen.de: any search or category URL, past the 1,250-ad limit. Watch a search for new and cheaper ads with alerts to Telegram, Slack or Discord, deal score vs. similar ads, car and flat fields, full details. Unofficial.",
    "version": "0.0",
    "x-build-id": "JTxWlGAQbGIAZpDQs"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~kleinanzeigen-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-kleinanzeigen-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~kleinanzeigen-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-kleinanzeigen-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~kleinanzeigen-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-kleinanzeigen-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": "Kleinanzeigen URLs",
            "type": "array",
            "description": "Any listing of kleinanzeigen.de: a search (https://www.kleinanzeigen.de/s-iphone-13/k0), a category (https://www.kleinanzeigen.de/s-autos/c216), a place with radius, or a search with the website's filters and sorting (set them on the website and paste the address of the results). Also ad URLs (https://www.kleinanzeigen.de/s-anzeige/<name>/<number>-<category>-<place>): an ad URL is read with its whole description and form fields 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\", \"golf 7\", \"e-bike\", \"2-zimmer-wohnung\". Each is a separate search (in every category and place chosen below). Leave empty to read whole categories.",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Categories to search or read. Empty = all categories.",
            "items": {
              "type": "string",
              "enum": [
                "210",
                "216",
                "223",
                "211",
                "217",
                "306",
                "305",
                "276",
                "280",
                "241",
                "220",
                "161",
                "172",
                "226",
                "245",
                "176",
                "408",
                "279",
                "278",
                "225",
                "228",
                "409",
                "173",
                "175",
                "285",
                "407",
                "227",
                "405",
                "406",
                "168",
                "80",
                "91",
                "93",
                "246",
                "239",
                "89",
                "90",
                "84",
                "86",
                "82",
                "81",
                "87",
                "88",
                "153",
                "224",
                "154",
                "159",
                "160",
                "158",
                "156",
                "157",
                "155",
                "17",
                "236",
                "22",
                "19",
                "258",
                "21",
                "237",
                "25",
                "20",
                "23",
                "18",
                "185",
                "232",
                "248",
                "187",
                "282",
                "240",
                "191",
                "249",
                "233",
                "234",
                "230",
                "250",
                "189",
                "242",
                "73",
                "76",
                "281",
                "284",
                "77",
                "79",
                "78",
                "74",
                "75",
                "130",
                "138",
                "134",
                "136",
                "132",
                "135",
                "139",
                "133",
                "283",
                "243",
                "313",
                "195",
                "199",
                "402",
                "196",
                "275",
                "197",
                "277",
                "207",
                "208",
                "205",
                "203",
                "403",
                "238",
                "198",
                "102",
                "118",
                "111",
                "114",
                "110",
                "105",
                "107",
                "125",
                "123",
                "247",
                "117",
                "109",
                "297",
                "288",
                "289",
                "290",
                "293",
                "291",
                "292",
                "294",
                "295",
                "296",
                "298",
                "231",
                "286",
                "254",
                "287",
                "252",
                "255",
                "257",
                "251",
                "256",
                "235",
                "269",
                "260",
                "265",
                "263",
                "264",
                "262",
                "268",
                "261",
                "271",
                "267",
                "266",
                "270",
                "272",
                "273",
                "274",
                "192",
                "400",
                "401"
              ],
              "enumTitles": [
                "Cars, bikes & boats (Auto, Rad & Boot): all",
                "Cars, bikes & boats › Autos",
                "Cars, bikes & boats › Autoteile & Reifen",
                "Cars, bikes & boats › Boote & Bootszubehör",
                "Cars, bikes & boats › Fahrräder & Zubehör",
                "Cars, bikes & boats › Motorradteile & Zubehör",
                "Cars, bikes & boats › Motorräder & Motorroller",
                "Cars, bikes & boats › Nutzfahrzeuge & Anhänger",
                "Cars, bikes & boats › Reparaturen & Dienstleistungen",
                "Cars, bikes & boats › Weiteres Auto, Rad & Boot",
                "Cars, bikes & boats › Wohnwagen & -mobile",
                "Electronics (Elektronik): all",
                "Electronics › Audio & Hifi",
                "Electronics › Dienstleistungen Elektronik",
                "Electronics › Foto",
                "Electronics › Haushaltsgeräte",
                "Electronics › Kommunikation & Funk",
                "Electronics › Konsolen",
                "Electronics › Laptops & Notebooks",
                "Electronics › PC-Zubehör & Software",
                "Electronics › PCs",
                "Electronics › Smartphone Zubehör",
                "Electronics › Smartphones",
                "Electronics › TV & Video",
                "Electronics › Tablets & Reader",
                "Electronics › Telefone & Fax",
                "Electronics › Videospiele",
                "Electronics › Wearables",
                "Electronics › Wearables Zubehör",
                "Electronics › Weitere Elektronik",
                "Home & garden (Haus & Garten): all",
                "Home & garden › Badezimmer",
                "Home & garden › Büro",
                "Home & garden › Dekoration",
                "Home & garden › Dienstleistungen Haus & Garten",
                "Home & garden › Gartenzubehör & Pflanzen",
                "Home & garden › Heimtextilien",
                "Home & garden › Heimwerken",
                "Home & garden › Küche & Esszimmer",
                "Home & garden › Lampen & Licht",
                "Home & garden › Schlafzimmer",
                "Home & garden › Weiteres Haus & Garten",
                "Home & garden › Wohnzimmer",
                "Fashion & beauty (Mode & Beauty): all",
                "Fashion & beauty › Beauty & Gesundheit",
                "Fashion & beauty › Damenbekleidung",
                "Fashion & beauty › Damenschuhe",
                "Fashion & beauty › Herrenbekleidung",
                "Fashion & beauty › Herrenschuhe",
                "Fashion & beauty › Taschen & Accessoires",
                "Fashion & beauty › Uhren & Schmuck",
                "Fashion & beauty › Weiteres Mode & Beauty",
                "Family, kids & baby (Familie, Kind & Baby): all",
                "Family, kids & baby › Altenpflege",
                "Family, kids & baby › Baby- & Kinderkleidung",
                "Family, kids & baby › Baby- & Kinderschuhe",
                "Family, kids & baby › Baby-Ausstattung",
                "Family, kids & baby › Babyschalen & Kindersitze",
                "Family, kids & baby › Babysitter/-in & Kinderbetreuung",
                "Family, kids & baby › Kinderwagen & Buggys",
                "Family, kids & baby › Kinderzimmermöbel",
                "Family, kids & baby › Spielzeug",
                "Family, kids & baby › Weiteres Familie, Kind & Baby",
                "Leisure, hobby & neighbourhood (Freizeit, Hobby & Nachbarschaft): all",
                "Leisure, hobby & neighbourhood › Esoterik & Spirituelles",
                "Leisure, hobby & neighbourhood › Essen & Trinken",
                "Leisure, hobby & neighbourhood › Freizeitaktivitäten",
                "Leisure, hobby & neighbourhood › Handarbeit, Basteln & Kunsthandwerk",
                "Leisure, hobby & neighbourhood › Kunst & Antiquitäten",
                "Leisure, hobby & neighbourhood › Künstler/-in & Musiker/-in",
                "Leisure, hobby & neighbourhood › Modellbau",
                "Leisure, hobby & neighbourhood › Reise & Eventservices",
                "Leisure, hobby & neighbourhood › Sammeln",
                "Leisure, hobby & neighbourhood › Sport & Camping",
                "Leisure, hobby & neighbourhood › Trödel",
                "Leisure, hobby & neighbourhood › Verloren & Gefunden",
                "Leisure, hobby & neighbourhood › Weiteres Freizeit, Hobby & Nachbarschaft",
                "Music, films & books (Musik, Filme & Bücher): all",
                "Music, films & books › Bücher & Zeitschriften",
                "Music, films & books › Büro & Schreibwaren",
                "Music, films & books › Comics",
                "Music, films & books › Fachbücher, Schule & Studium",
                "Music, films & books › Film & DVD",
                "Music, films & books › Musik & CDs",
                "Music, films & books › Musikinstrumente",
                "Music, films & books › Weitere Musik, Filme & Bücher",
                "Pets (Haustiere): all",
                "Pets › Fische",
                "Pets › Hunde",
                "Pets › Katzen",
                "Pets › Kleintiere",
                "Pets › Nutztiere",
                "Pets › Pferde",
                "Pets › Tierbetreuung & Training",
                "Pets › Vermisste Tiere",
                "Pets › Vögel",
                "Pets › Zubehör",
                "Real estate (Immobilien): all",
                "Real estate › Auf Zeit & WG",
                "Real estate › Container",
                "Real estate › Eigentumswohnungen",
                "Real estate › Ferien- & Auslandsimmobilien",
                "Real estate › Garagen & Stellplätze",
                "Real estate › Gewerbeimmobilien",
                "Real estate › Grundstücke & Gärten",
                "Real estate › Häuser zum Kauf",
                "Real estate › Häuser zur Miete",
                "Real estate › Mietwohnungen",
                "Real estate › Neubauprojekte",
                "Real estate › Umzug & Transport",
                "Real estate › Weitere Immobilien",
                "Jobs: all",
                "Jobs › Ausbildung",
                "Jobs › Bau, Handwerk & Produktion",
                "Jobs › Büroarbeit & Verwaltung",
                "Jobs › Gastronomie & Tourismus",
                "Jobs › Kundenservice & Call Center",
                "Jobs › Mini- & Nebenjobs",
                "Jobs › Praktika",
                "Jobs › Sozialer Sektor & Pflege",
                "Jobs › Transport, Logistik & Verkehr",
                "Jobs › Vertrieb, Einkauf & Verkauf",
                "Jobs › Weitere Jobs",
                "Services (Dienstleistungen): all",
                "Services › Altenpflege",
                "Services › Auto, Rad & Boot",
                "Services › Babysitter/-in & Kinderbetreuung",
                "Services › Elektronik",
                "Services › Haus & Garten",
                "Services › Künstler/-in & Musiker/-in",
                "Services › Reise & Event",
                "Services › Tierbetreuung & Training",
                "Services › Umzug & Transport",
                "Services › Weitere Dienstleistungen",
                "Tickets (Eintrittskarten & Tickets): all",
                "Tickets › Bahn & ÖPNV",
                "Tickets › Comedy & Kabarett",
                "Tickets › Gutscheine",
                "Tickets › Kinder",
                "Tickets › Konzerte",
                "Tickets › Sport",
                "Tickets › Theater & Musical",
                "Tickets › Weitere Eintrittskarten & Tickets",
                "Lessons & courses (Unterricht & Kurse): all",
                "Lessons & courses › Beauty & Gesundheit",
                "Lessons & courses › Computerkurse",
                "Lessons & courses › Esoterik & Spirituelles",
                "Lessons & courses › Kochen & Backen",
                "Lessons & courses › Kunst & Gestaltung",
                "Lessons & courses › Musik & Gesang",
                "Lessons & courses › Nachhilfe",
                "Lessons & courses › Sportkurse",
                "Lessons & courses › Sprachkurse",
                "Lessons & courses › Tanzkurse",
                "Lessons & courses › Weiterbildung",
                "Lessons & courses › Weitere Unterricht & Kurse ",
                "Free & swap (Verschenken & Tauschen): all",
                "Free & swap › Tauschen",
                "Free & swap › Verleihen",
                "Free & swap › Verschenken",
                "Neighbourhood help (Nachbarschaftshilfe): all",
                "Neighbourhood help › Nachbarschaftshilfe"
              ]
            }
          },
          "locations": {
            "title": "Places",
            "type": "array",
            "description": "Postal codes or German towns to search around, e.g. \"10115\", \"Hamburg\", \"München\". Each is a separate search. Empty = all of Germany.",
            "items": {
              "type": "string"
            }
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 0,
            "maximum": 200,
            "type": "integer",
            "description": "With \"Places\": how far around the place. The website offers 5, 10, 20, 30, 50, 100, 150 and 200 km (another number is rounded to the nearest of them). 0 = only the place.",
            "default": 0
          },
          "minPrice": {
            "title": "Price from (€)",
            "minimum": 0,
            "type": "integer",
            "description": "The website's price filter in euros. Ads without an amount (only \"VB\") 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 euros."
          },
          "adType": {
            "title": "Ad type",
            "enum": [
              "all",
              "offers",
              "wanted"
            ],
            "type": "string",
            "description": "Offers of sellers, ads of buyers who look for something, or both.",
            "default": "all"
          },
          "sellerType": {
            "title": "Seller",
            "enum": [
              "all",
              "private",
              "commercial"
            ],
            "type": "string",
            "description": "The website's seller filter. With it, every row has its sellerType.",
            "default": "all"
          },
          "shipping": {
            "title": "Shipping",
            "enum": [
              "all",
              "shipping",
              "pickup"
            ],
            "type": "string",
            "description": "The website's shipping filter.",
            "default": "all"
          },
          "buyNowOnly": {
            "title": "Only \"Direkt kaufen\" ads",
            "type": "boolean",
            "description": "Only ads that can be bought directly with the website's payment and shipping.",
            "default": false
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "newest",
              "price",
              "website"
            ],
            "type": "string",
            "description": "The order of the searches built from the inputs above (pasted URLs keep their own order).",
            "default": "newest"
          },
          "adIds": {
            "title": "Ad numbers",
            "type": "array",
            "description": "Numbers of ads (Anzeigen-ID, e.g. 3570529592) to read with their whole ad page; charged like ad URLs.",
            "items": {
              "type": "string"
            }
          },
          "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 (25 ads each) of every search. 0 = no limit.",
            "default": 0
          },
          "deepSearch": {
            "title": "Read past 1,250 ads",
            "type": "boolean",
            "description": "The website shows at most 1,250 ads of one search. On: a bigger search is read in full, so you can get all its ads (only when \"Max ads\" asks for more than 1,250; ads without an amount, only \"VB\", are then found only among the first 1,250). Charged as \"Read past 1,250 ads\" per saved ad of such a search except its first page (see the Pricing tab). Off: every search stops at 1,250 ads.",
            "default": false
          },
          "includeDetails": {
            "title": "Add ad page details",
            "type": "boolean",
            "description": "Open each ad page to add its whole description (e-mails and phone numbers removed), the form fields of the category (brand, model, condition, mileage, fuel, rooms, extra costs…) as attributes, the equipment list, every photo, the region, shipping, the map point and whether the seller is private or commercial. 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, date, photo, TOP, shipping, mileage and first registration of cars, living area and rooms of flats).",
            "default": false
          },
          "includeVehicleFields": {
            "title": "Add vehicle fields (cars, motorbikes, caravans, vans)",
            "type": "boolean",
            "description": "For ads of cars, motorbikes, caravans and commercial vehicles: make, model, year and first registration, mileage, power (kW and PS), engine size, fuel, gearbox, body type, colour and damage, normalized from the form fields of the ad page (with \"Add ad page details\") or else from the listing and the text. 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)",
            "type": "boolean",
            "description": "For ads of electronics: brand, model, storage (GB), RAM, battery health (%), condition (new, like new, used, for parts) and warranty, from the form fields of the ad page (with \"Add ad page details\") and the text. 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. With monitoring turn \"read only new ads\" off to see the prices of older ads too. 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 of the same category (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 umlauts 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. \"defekt\", \"Bastler\", \"Hülle\".",
            "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 the listing).",
            "default": false
          },
          "skipWantedAds": {
            "title": "Skip \"wanted\" ads",
            "type": "boolean",
            "description": "Skip ads of people who buy instead of selling (\"Gesuch\", \"Suche…\", \"Kaufe…\", \"Ankauf…\"). Every row has isWanted either way.",
            "default": false
          },
          "onlyWithPrice": {
            "title": "Only ads with an amount",
            "type": "boolean",
            "description": "Skip ads without an amount as their price (\"VB\" only, \"Zu verschenken\").",
            "default": false
          },
          "onlyWithPhotos": {
            "title": "Only ads with photos",
            "type": "boolean",
            "description": "Skip ads without a photo.",
            "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 search sorted by newest is read only until the older ads begin. Real estate listings show no date, so their ads are left out by this filter unless \"Add ad page details\" is on. 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\", \"Golf 7 Variant\". An ad matches when its title has every word of the item and no accessory words (Hülle, Case, Panzerglas…). 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 (25 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 = 25 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-berlin\"). 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, a check finds the ads posted since the previous check and stops at the ads it already knows, so a check without news costs a fraction of a cent. Older ads promoted to the top again are not reported as new. The first run reads the search as usual. Off = read the whole search every run (finds price changes of older ads too). Turned off by \"include removed\", \"include unchanged\" and \"market report\".",
            "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 number. 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 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, category, date, TOP, seller type, photo, deal score, link (and the monitoring, vehicle and item 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}