{
  "openapi": "3.0.1",
  "info": {
    "title": "ImmoScout24 Scraper ($0.59/1K): Rent, Buy & Price Alerts",
    "description": "Scrape ImmoScout24 (immobilienscout24.de) apartments and houses for rent and sale in any German city, district or postcode: price, cold and warm rent, m², rooms, address, agency, energy class; details, deal score, rental yield, alerts.",
    "version": "0.0",
    "x-build-id": "ABNuCawqTeyARCqoj"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~immoscout24-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-immoscout24-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~immoscout24-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-immoscout24-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~immoscout24-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-immoscout24-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": {
          "searchLocations": {
            "title": "Locations",
            "type": "array",
            "description": "Places to search, as you would type them on ImmoScout24: a city (Berlin, München), a district or quarter (Berlin-Prenzlauer Berg, München-Schwabing), a county (Landkreis Ebersberg), a state (Bayern) or a postcode (10115). A listing found in several searches is saved once.",
            "items": {
              "type": "string"
            }
          },
          "realEstateType": {
            "title": "Property type",
            "enum": [
              "apartmentrent",
              "apartmentbuy",
              "houserent",
              "housebuy",
              "livingbuysite",
              "livingrentsite",
              "flatshareroom",
              "shorttermaccommodation",
              "garagerent",
              "garagebuy",
              "investment",
              "compulsoryauction",
              "officerent",
              "officebuy",
              "storerent",
              "storebuy",
              "gastronomyrent",
              "gastronomybuy",
              "industryrent",
              "industrybuy",
              "specialpurposerent",
              "specialpurposebuy",
              "tradesiterent",
              "tradesitebuy"
            ],
            "type": "string",
            "description": "What to search in the locations and the radius. Commercial types (offices, shops, gastronomy, halls, special-purpose property, commercial plots) take the price, area and commission filters. ImmoScout24 search URLs keep their own type.",
            "default": "apartmentrent"
          },
          "maxItems": {
            "title": "Max listings",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of listings saved. You pay per saved listing. 0 = no limit.",
            "default": 100
          },
          "startUrls": {
            "title": "ImmoScout24 URLs",
            "type": "array",
            "description": "Search pages copied from the browser with any filters, radius or drawn map area (e.g. https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?price=-1500.0&numberofrooms=2.0-) and listing URLs (https://www.immobilienscout24.de/expose/172626075), read with their listing details. A search URL keeps its own filters and sort order.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "listingIds": {
            "title": "Listing IDs",
            "type": "array",
            "description": "ImmoScout24 listing IDs (the number in a listing URL, e.g. 172626075): each listing is read with its listing details.",
            "items": {
              "type": "string"
            }
          },
          "radiusCenter": {
            "title": "Radius centre",
            "type": "string",
            "description": "Search a circle around an address, a place or a map point instead of (or besides) the locations: e.g. \"Alexanderplatz 1, Berlin\", \"Marienplatz, München\" or \"52.52, 13.405\". An address is located with OpenStreetMap. Every listing gets its distance from the centre (distanceKm) when it shows its map point."
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 0.1,
            "maximum": 200,
            "type": "number",
            "description": "Radius around the centre in km (default 5)."
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "newest",
              "relevance",
              "priceAsc",
              "priceDesc",
              "areaAsc",
              "areaDesc"
            ],
            "type": "string",
            "description": "Order of the results. Newest first is best for monitoring new listings.",
            "default": "newest"
          },
          "minPrice": {
            "title": "Min price (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Purchase price, or for rentals the monthly cold rent (Kaltmiete)."
          },
          "maxPrice": {
            "title": "Max price (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Purchase price, or for rentals the monthly cold rent (Kaltmiete)."
          },
          "priceIsWarmRent": {
            "title": "Rent filter on warm rent",
            "type": "boolean",
            "description": "Rentals: apply the min and max price to the warm rent (Warmmiete) instead of the cold rent.",
            "default": false
          },
          "minLivingSpace": {
            "title": "Min living area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Smallest living area (Wohnfläche) in square metres."
          },
          "maxLivingSpace": {
            "title": "Max living area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Largest living area (Wohnfläche) in square metres."
          },
          "minRooms": {
            "title": "Min rooms",
            "minimum": 0,
            "maximum": 50,
            "type": "number",
            "description": "German room count (living rooms and bedrooms, without kitchen and bath); e.g. 2 or 2.5."
          },
          "maxRooms": {
            "title": "Max rooms",
            "minimum": 0,
            "maximum": 50,
            "type": "number",
            "description": "Most rooms (German room count, e.g. 3 or 3.5)."
          },
          "minPlotArea": {
            "title": "Min plot area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Houses and plots: Grundstücksfläche."
          },
          "maxPlotArea": {
            "title": "Max plot area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Houses and plots: Grundstücksfläche."
          },
          "minYearBuilt": {
            "title": "Min year built",
            "minimum": 1500,
            "maximum": 2100,
            "type": "integer",
            "description": "Oldest year of construction (Baujahr)."
          },
          "maxYearBuilt": {
            "title": "Max year built",
            "minimum": 1500,
            "maximum": 2100,
            "type": "integer",
            "description": "Newest year of construction (Baujahr)."
          },
          "equipment": {
            "title": "Features",
            "type": "array",
            "description": "Only listings with all of these features (empty = any).",
            "items": {
              "type": "string",
              "enum": [
                "balcony",
                "builtinkitchen",
                "garden",
                "lift",
                "cellar",
                "guesttoilet",
                "handicappedaccessible",
                "garage"
              ],
              "enumTitles": [
                "Balcony or terrace",
                "Fitted kitchen (Einbauküche)",
                "Garden",
                "Elevator",
                "Cellar",
                "Guest toilet",
                "Step-free access",
                "Garage or parking space"
              ]
            }
          },
          "energyClasses": {
            "title": "Energy classes",
            "type": "array",
            "description": "Only listings with one of these energy efficiency classes (empty = any; listings without a class are left out when set).",
            "items": {
              "type": "string",
              "enum": [
                "a_plus",
                "a",
                "b",
                "c",
                "d",
                "e",
                "f",
                "g",
                "h"
              ],
              "enumTitles": [
                "A+",
                "A",
                "B",
                "C",
                "D",
                "E",
                "F",
                "G",
                "H"
              ]
            }
          },
          "apartmentTypes": {
            "title": "Apartment types",
            "type": "array",
            "description": "Apartments: only these types (empty = any).",
            "items": {
              "type": "string",
              "enum": [
                "apartment",
                "roofstorey",
                "loft",
                "maisonette",
                "penthouse",
                "terracedflat",
                "groundfloor",
                "raisedgroundfloor",
                "halfbasement",
                "other"
              ],
              "enumTitles": [
                "Apartment (Etagenwohnung)",
                "Attic flat (Dachgeschoss)",
                "Loft",
                "Maisonette",
                "Penthouse",
                "Terrace flat",
                "Ground floor",
                "Raised ground floor",
                "Basement flat (Souterrain)",
                "Other"
              ]
            }
          },
          "minFloor": {
            "title": "Min floor",
            "minimum": -5,
            "maximum": 200,
            "type": "integer",
            "description": "Apartments: lowest floor (0 = ground floor)."
          },
          "maxFloor": {
            "title": "Max floor",
            "minimum": -5,
            "maximum": 200,
            "type": "integer",
            "description": "Apartments: highest floor (0 = ground floor)."
          },
          "excludeNewBuildProjects": {
            "title": "Exclude new-build projects",
            "type": "boolean",
            "description": "Leave out listings of developers' new-build projects (Neubauprojekte).",
            "default": false
          },
          "onlyNewBuildings": {
            "title": "Only new buildings",
            "type": "boolean",
            "description": "Only new buildings (Neubau).",
            "default": false
          },
          "excludeSwapFlats": {
            "title": "Exclude flat swaps",
            "type": "boolean",
            "description": "Apartments: leave out flat swap offers (Wohnungstausch).",
            "default": false
          },
          "commissionFree": {
            "title": "Commission-free only (provisionsfrei)",
            "type": "boolean",
            "description": "Only listings without a commission for the buyer or tenant.",
            "default": false
          },
          "petsAllowed": {
            "title": "Pets allowed",
            "type": "array",
            "description": "Rentals (apartments, houses, flat shares, temporary living): only listings that allow pets, or allow them by arrangement (empty = any).",
            "items": {
              "type": "string",
              "enum": [
                "yes",
                "negotiable"
              ],
              "enumTitles": [
                "Yes",
                "By arrangement"
              ]
            }
          },
          "heatingTypes": {
            "title": "Heating types",
            "type": "array",
            "description": "Apartments and houses: only these heating types (empty = any).",
            "items": {
              "type": "string",
              "enum": [
                "central",
                "selfcontainedcentral",
                "stove"
              ],
              "enumTitles": [
                "Central heating",
                "Self-contained central heating (Etagenheizung)",
                "Stove heating (Ofenheizung)"
              ]
            }
          },
          "buildingTypes": {
            "title": "House types",
            "type": "array",
            "description": "Houses: only these house types (empty = any).",
            "items": {
              "type": "string",
              "enum": [
                "singlefamilyhouse",
                "multifamilyhouse",
                "semidetachedhouse",
                "terracehouse",
                "midterracehouse",
                "endterracehouse",
                "bungalow",
                "villa",
                "farmhouse",
                "castlemanorhouse",
                "specialrealestate",
                "otherrealestate"
              ],
              "enumTitles": [
                "Detached house (Einfamilienhaus)",
                "Multi-family house",
                "Semi-detached house",
                "Terraced house",
                "Mid-terrace house",
                "End-terrace house",
                "Bungalow",
                "Villa",
                "Farmhouse",
                "Castle or manor house",
                "Special property",
                "Other"
              ]
            }
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "all",
              "agency",
              "private"
            ],
            "type": "string",
            "description": "Keep only listings of agencies (brokers, housing companies, developers) or only private listings.",
            "default": "all"
          },
          "titleKeywords": {
            "title": "Title keywords",
            "type": "array",
            "description": "Keep only listings whose title contains at least one of these words (e.g. Altbau, Dachgeschoss, provisionsfrei).",
            "items": {
              "type": "string"
            }
          },
          "excludeTitleKeywords": {
            "title": "Exclude title keywords",
            "type": "array",
            "description": "Leave out listings whose title contains any of these words (e.g. WBS, Tausch, Senioren).",
            "items": {
              "type": "string"
            }
          },
          "maxDaysOnline": {
            "title": "Max days online",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "Keep only listings online at most this many days (from what ImmoScout24 shows, e.g. \"vor 4 Tagen\"; approximate for months). With newest first the search stops at older listings."
          },
          "onlyPlusListings": {
            "title": "Only early access (Plus) listings",
            "type": "boolean",
            "description": "Keep only the newest listings ImmoScout24 shows to its paying members (Suchen+) first.",
            "default": false
          },
          "maxPricePerSqm": {
            "title": "Max price per m² (EUR)",
            "minimum": 0,
            "type": "number",
            "description": "Keep only listings at most this expensive per m² of living area (plots: plot area); rentals: cold rent per m². Listings without an area are left out."
          },
          "minDealScore": {
            "title": "Min deal score",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Keep only listings with at least this deal score (50 = the usual price per m² of comparable listings in the same postcode, higher = cheaper)."
          },
          "minGrossYieldPercent": {
            "title": "Min gross rental yield (%)",
            "minimum": 0,
            "type": "number",
            "description": "Apartments for sale, with \"Add rental yield\": keep only those with at least this gross yield."
          },
          "includeDetails": {
            "title": "Add listing details",
            "type": "boolean",
            "description": "Read every listing page: cold and warm rent, service charges, heating costs, deposit, Hausgeld, buyer's commission and total purchase costs, floor, bedrooms, bathrooms, year built, condition, heating, energy certificate and consumption, features (balcony, garden, elevator, cellar, fitted kitchen...), available from, pets, the description texts, all photos, the agency with its rating, and ImmoScout24's price range of similar listings. Charged as \"Listing details\" ($0.19 per 1,000 listings).",
            "default": false
          },
          "includeAgencyPhone": {
            "title": "Add agency phone numbers",
            "type": "boolean",
            "description": "With \"Add listing details\": the phone number an agency or company shows on its listing. Never for private sellers. No extra charge (part of the listing details). These are business contacts; use them according to the GDPR.",
            "default": false
          },
          "includeContactPerson": {
            "title": "Contact person (personal data)",
            "type": "boolean",
            "description": "With \"Add listing details\": the name, salutation and phone number of the contact person the listing shows (an agent, a team or a private seller who shows them). This is personal data: you are responsible for processing it lawfully (GDPR), e.g. only with a legitimate interest and never for unsolicited advertising. Charged as \"Contact person\" per listing that has one (see the Pricing tab).",
            "default": false
          },
          "includeRentalYield": {
            "title": "Add rental yield",
            "type": "boolean",
            "description": "Apartments for sale: the run also reads apartments for rent of the same place and adds an estimated monthly cold rent and the gross rental yield (12 × rent / price) from comparable rentals of the same postcode and room count. Charged as \"Rental yield\" ($0.30 per 1,000 apartments) only for apartments that get a yield.",
            "default": false
          },
          "includePriceHistory": {
            "title": "Price history",
            "type": "boolean",
            "description": "Remember the price of every listing your runs see (per Monitoring key) and add its history: since when your runs see it, every price with its date, the number of changes and price drops, the lowest and highest price of 30 and 90 days. Charged as \"Price history\" per listing whose history goes back before this run (the first run only starts it).",
            "default": false
          },
          "includeMarketReport": {
            "title": "Market report",
            "type": "boolean",
            "description": "MARKET_REPORT in the key-value store: per postcode and per town the quartiles of the price and the price per m², the median area and days online, new listings of 7 days, the share of private sellers and the same by room count; for apartments for rent a rent index by postcode and rooms (asking rents, like a Mietspiegel). Charged once per run as \"Market report\".",
            "default": false
          },
          "includeAgencyDirectory": {
            "title": "Agency directory",
            "type": "boolean",
            "description": "With \"Add listing details\": AGENCY_DIRECTORY (JSON and CSV) in the key-value store, one entry per agency of the saved listings: listings in your results, kinds of listing, cities and postcodes, median price, address, phone, fax, e-mail and website from its imprint, rating and ImmoScout24 profile. Business contacts; use them according to the GDPR. Charged as \"Agency directory\" per agency.",
            "default": false
          },
          "language": {
            "title": "Language",
            "enum": [
              "de",
              "en"
            ],
            "type": "string",
            "description": "English: the titles of the search results in ImmoScout24's English translation (originalTitle keeps the German one). Descriptions stay as the seller wrote them.",
            "default": "de"
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Only the main fields: title, type, price, price per m², living area, rooms, postcode, city, quarter, seller type, deal score, yield, photo, URL and the monitoring fields.",
            "default": false
          },
          "maxItemsPerSearch": {
            "title": "Max listings per search",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum per location or search URL. Empty = no limit."
          },
          "skipItems": {
            "title": "Skip first results",
            "minimum": 0,
            "type": "integer",
            "description": "Skip this many results at the top of every search (e.g. 500 to go on where an earlier run with \"Max listings\" 500 stopped). Skipped results are not read further and not charged."
          },
          "onlyNewOrChanged": {
            "title": "Monitoring: only new or changed listings",
            "type": "boolean",
            "description": "Return new listings, and listings whose price changed, with the previous price.",
            "default": false
          },
          "monitoringKey": {
            "title": "Monitoring key",
            "type": "string",
            "description": "Name of the remembered state; use a different key for every saved search. Empty = \"default\"."
          },
          "monitoringEarlyStop": {
            "title": "Monitoring: stop at known listings",
            "type": "boolean",
            "description": "With newest first: stop a search as soon as it reaches listings already known (fast, cheap checks). Turn it off to see price changes of older listings and to report listings that left the search.",
            "default": true
          },
          "onlyNew": {
            "title": "Monitoring: only new listings",
            "type": "boolean",
            "description": "Return new listings only, not changed ones.",
            "default": false
          },
          "onlyPriceDrops": {
            "title": "Monitoring: only price drops",
            "type": "boolean",
            "description": "Of the changed listings, return only those whose price went down.",
            "default": false
          },
          "minPriceDropPercent": {
            "title": "Monitoring: min price drop (%)",
            "minimum": 0,
            "type": "integer",
            "description": "Of the changed listings, return only those whose price went down by at least this many %."
          },
          "includeRemovedListings": {
            "title": "Monitoring: report listings that left the search",
            "type": "boolean",
            "description": "Listings of the previous run that are no longer in the search: the actor checks each one and returns it with removedReason removed (taken off ImmoScout24, e.g. rented or sold) or noLongerMatches (still online, no longer in your search). Works for searches read in full with \"Monitoring: stop at known listings\" off. Each check is charged as a monitoring page.",
            "default": false
          },
          "skipFirstRun": {
            "title": "Monitoring: silent first run",
            "type": "boolean",
            "description": "The first run only remembers the listings and returns nothing; later runs return what is new.",
            "default": false
          },
          "resetMonitoring": {
            "title": "Monitoring: start again",
            "type": "boolean",
            "description": "Forget the remembered listings of this Monitoring key.",
            "default": false
          },
          "telegramBotToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Token of your bot from @BotFather."
          },
          "telegramChatId": {
            "title": "Telegram chat ID",
            "type": "string",
            "description": "Chat, group or channel to send to (e.g. 123456789 or -1001234567890)."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "Incoming webhook (https://hooks.slack.com/...)."
          },
          "discordWebhookUrl": {
            "title": "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."
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Any HTTPS URL (Zapier, Make, n8n, your server): receives the listings as JSON."
          },
          "whatsappAccessToken": {
            "title": "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": "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": "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": "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": "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": "Max listings per notification",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many listings the message lists.",
            "default": 10
          },
          "notifyOnlyChanges": {
            "title": "Notify only when something was found",
            "type": "boolean",
            "description": "No message after a run that saved nothing.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "No proxy needed. If ImmoScout24 keeps refusing your runs, switch to Apify Proxy with the RESIDENTIAL group and country Germany; a run through a residential proxy may be charged a little more to cover its traffic.",
            "default": {
              "useApifyProxy": false
            }
          },
          "exportFormats": {
            "title": "Extra export formats",
            "type": "array",
            "description": "Off by default. Printable HTML report: the results as a clean, branded table with the main columns, made for printing, saving as PDF or sending to someone; for working with the data use Excel or CSV, which have every field. Markdown table: the same columns as text for AI tools, docs or GitHub. The Output tab links the files. Each file has the overview columns of every saved row and nothing is left out, so a run with tens of thousands of rows makes a file of tens of MB that can be slow to open; for big runs use the dataset or its Excel export. Excel (XLSX), CSV and JSON are always in the Output tab and under Export, at no extra cost.",
            "items": {
              "type": "string",
              "enum": [
                "html",
                "markdown"
              ],
              "enumTitles": [
                "Printable HTML report",
                "Markdown table"
              ]
            },
            "default": []
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}