{
  "openapi": "3.0.1",
  "info": {
    "title": "Interencheres Scraper - Auction Lots, Hammer Prices & Houses",
    "description": "Scrape interencheres.com, France's largest auction network: 167,000+ upcoming lots with estimates, photos and the day's hammer prices, plus sales and 541 auction houses with email, phone, address and SIREN. Filter by category, region, date, estimate or auction type; monitor new lots.",
    "version": "0.1",
    "x-build-id": "vw6aKGWi0FMWlBc4U"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~interencheres-auction-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-interencheres-auction-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/scrapersdelight~interencheres-auction-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-interencheres-auction-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/scrapersdelight~interencheres-auction-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-interencheres-auction-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": {
          "mode": {
            "title": "What to scrape",
            "enum": [
              "lots",
              "results",
              "sales",
              "houses"
            ],
            "type": "string",
            "description": "Lots = upcoming lots of the site's lot search. Results = lots already under the hammer, with the hammer price (the site keeps a sale's lots until the end of its sale day). Sales = the sales calendar. Auction houses = the directory of houses.",
            "default": "lots"
          },
          "searchQueries": {
            "title": "Search terms",
            "type": "array",
            "description": "The site's own full-text search, one search per term, e.g. \"montre\", \"Rolex\", \"Peugeot 205\", \"tableau\". Empty = no text filter.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Interencheres page links",
            "type": "array",
            "description": "Links copied from interencheres.com: a search (/recherche/lots?..., /recherche/ventes?..., filters and page kept), a category (/vehicules/...), a sale, a lot, an auction house (/commissaire-priseur/...) or /resultats-ventes. A link brings its own filters: the form filters below do not apply to it.",
            "items": {
              "type": "string"
            }
          },
          "saleIds": {
            "title": "Sale ids",
            "type": "array",
            "description": "Numeric sale ids (the number at the end of a sale link, e.g. 690874). Lots / Results modes: every lot of the sale. Sales mode: the sale row.",
            "items": {
              "type": "string"
            }
          },
          "houseIds": {
            "title": "Auction-house ids",
            "type": "array",
            "description": "Numeric auction-house ids (the number at the end of a /commissaire-priseur/ link, e.g. 34). Lots, Results and Sales modes: only that house's lots or sales. Auction houses mode: those houses.",
            "items": {
              "type": "string"
            }
          },
          "pastSales": {
            "title": "Past sales (results PDF)",
            "type": "boolean",
            "description": "Sales mode only: read the site's archive of ended sales (24,000+ since 2007) with each sale's results PDF, instead of the upcoming calendar.",
            "default": false
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "The site's own category tree (3 universes, 153 categories). A parent category includes everything under it.",
            "items": {
              "type": "string",
              "enum": [
                "500",
                "501",
                "502",
                "503",
                "504",
                "505",
                "506",
                "507",
                "508",
                "509",
                "510",
                "511",
                "512",
                "536",
                "542",
                "545",
                "543",
                "544",
                "541",
                "537",
                "538",
                "539",
                "540",
                "547",
                "548",
                "549",
                "550",
                "551",
                "552",
                "553",
                "554",
                "555",
                "556",
                "562",
                "557",
                "558",
                "559",
                "560",
                "513",
                "514",
                "515",
                "516",
                "517",
                "518",
                "519",
                "520",
                "521",
                "522",
                "642",
                "523",
                "643",
                "524",
                "525",
                "526",
                "654",
                "527",
                "644",
                "645",
                "528",
                "529",
                "530",
                "531",
                "532",
                "533",
                "534",
                "535",
                "653",
                "649",
                "650",
                "651",
                "652",
                "613",
                "635",
                "639",
                "638",
                "636",
                "637",
                "622",
                "624",
                "625",
                "626",
                "623",
                "619",
                "620",
                "614",
                "615",
                "616",
                "617",
                "627",
                "628",
                "629",
                "630",
                "631",
                "632",
                "633",
                "634",
                "563",
                "594",
                "595",
                "596",
                "599",
                "598",
                "597",
                "621",
                "600",
                "601",
                "602",
                "603",
                "609",
                "610",
                "612",
                "611",
                "561",
                "604",
                "608",
                "607",
                "606",
                "605",
                "568",
                "569",
                "570",
                "571",
                "572",
                "573",
                "574",
                "577",
                "576",
                "575",
                "648",
                "579",
                "580",
                "581",
                "582",
                "584",
                "585",
                "586",
                "587",
                "588",
                "589",
                "590",
                "591",
                "592",
                "646",
                "593",
                "647",
                "564",
                "565",
                "566",
                "567",
                "578",
                "640",
                "583",
                "641"
              ],
              "enumTitles": [
                "Art, Décoration et Collections (Art, Decoration and Collectables)",
                " Art",
                "  Peintures et Dessins",
                "   Dessins, aquarelles et pastels",
                "   Estampes, lithographies et sérigraphies",
                "   Tableaux anciens",
                "   Tableaux modernes et contemporains",
                "   Techniques mixtes et autres",
                "  Photographie et Art Numérique",
                "   Art numérique et NFT",
                "   Photographie",
                "   Reproductions digitales",
                "  Sculptures et bronzes",
                " Décoration et mobilier",
                "  Mobilier",
                "   Mobilier moderne et design",
                "   Mobilier ancien",
                "   Mobilier extérieur",
                "  Luminaires",
                "  Art de la Table et Argenterie",
                "   Argenterie et orfèvrerie",
                "   Porcelaines et faïences",
                "   Verrerie et cristal",
                "  Objets décoratifs",
                "   Céramiques, poteries et faïences",
                "   Décorations murales et miroirs",
                "   Horlogerie",
                "   Objets de vitrine, flacons, parfums",
                "   Objets en métal et dinanderie",
                "   Vases et objets en verre",
                "  Tapis, Textiles et Tapisseries",
                " Mode et Bijoux",
                "  Bijoux",
                "  Montres",
                "  Mode et Accessoires",
                "   Accessoires de mode",
                "   Sacs et maroquinerie",
                "   Vêtements",
                " Civilisations et Cultures",
                "  Archéologie et Antiquités",
                "  Art Religieux",
                "  Arts Premiers",
                "  Arts Asie",
                "  Arts du moyen orient et de méditerranée",
                " Collections",
                "  Arts populaires",
                "  BD, manga et comics",
                "  Chasse et armes",
                "  Objets de Curiosité",
                "   Curiosité et histoire naturelle",
                "   Instruments scientifiques et techniques",
                "  Jouets et Modélisme",
                "  Livres, manuscrits, vieux papiers et documents historiques",
                "  Militaria",
                "  Instruments, Partitions, CD et Vinyles",
                "   Instruments de musique",
                "   Partitions et livres de musique",
                "   CD, vinyles et supports audio",
                "  Numismatique",
                "  Philatélie et cartes postales",
                "  Souvenirs et Memorabilia",
                "   Automobilia",
                "   Cinéma et spectacle",
                "   Musique",
                "   Sport",
                "  Vin et Spiritueux",
                " Or et Métaux d'Investissement",
                "  Lingots et Lingotins",
                "  Médailles et jetons en métaux précieux",
                "  Métaux précieux à la casse (pour refonte)",
                "  Pièces d’investissement",
                "Véhicules (Vehicles)",
                " Véhicules de Sport et de Collection",
                "  Voitures de sport",
                "  Voitures de collection",
                "  Deux-roues de collection",
                "  Voitures Hippomobiles",
                " Véhicules Particuliers et de Loisirs",
                "  Véhicules particuliers",
                "  Véhicules sans Permis",
                "  Véhicules électriques et hybrides",
                "  Camping-cars et véhicules de loisirs",
                "  Motos et Scooters",
                "  Quads et Buggys",
                " Aérien, Maritime et Ferroviaire",
                "  Avions et Hélicoptères",
                "  Bateaux",
                "  Ferroviaire",
                " Véhicules professionnels",
                "  Autocars, Bus et Minibus",
                "  Camions et Poids Lourds",
                "  Engins de chantier",
                "  Remorques et Semi-Remorques",
                "  Utilitaires et Véhicules Commerciaux",
                "  Véhicules agricoles",
                "  Véhicules Spéciaux",
                "Biens d'équipement (Equipment goods)",
                " Objets du Quotidien",
                "  Informatique et Téléphonie",
                "   Ordinateurs portables et fixes",
                "   Téléphones mobiles et smartphones",
                "   Tablettes et accessoires",
                "   Périphériques et composants informatiques",
                "  Vélos, Trottinettes et Skates",
                "  Loisirs et Multimédia",
                "   Appareils photo et caméras",
                "   Consoles de jeux et accessoires",
                "   Télévisions et équipements home cinéma",
                "  Électroménager et Maison",
                "   Éclairage",
                "   Petit électroménager",
                "   Gros électroménager",
                "   Mobilier de Maison",
                "  Outillage et Jardinage",
                "   Outils électriques",
                "   Outils à main",
                "   Outils de jardinage",
                "   Mobilier et équipement extérieur",
                " Marchandises neuves et stocks",
                " Matériels professionnels",
                "  Agriculture et Élevage",
                "   Matériel agricole",
                "   Matériel élevage",
                "   Équipements pour cultures spécifiques",
                "  BTP et Construction",
                "   Outillage BTP",
                "   Matériel de chantier",
                "   Engins de terrassement",
                "   Matériaux de construction",
                "  Commerces et Services",
                "  Industrie et Usinage",
                "   Industries du plastique",
                "   Matériel de menuiserie et scierie",
                "   Mécanique générale",
                "   Tissage, confection et blanchisserie",
                "  Logistique et manutention",
                "   Matériel de manutention",
                "   Matériel de stockage",
                "  Secteurs Spécialisés",
                "   Imprimerie et papeterie",
                "   Matériel médical",
                "   Métiers de bouche et CHR",
                "   Matériel de nettoyage et maintenance industrielle",
                "   Secteur activité spécifiques",
                "  Mobilier de bureau",
                " Bien immatériels",
                "  Fonds de commerce",
                "  Licences",
                "  Propriété intellectuelle",
                " Chevaux, élevage et nature",
                " Véhicules – Mécanique et accessoires",
                "  Mécanique automobile",
                "  Équipements et accessoires pour véhicules"
              ]
            }
          },
          "regions": {
            "title": "Regions / departments",
            "type": "array",
            "description": "Where the sale takes place: the site's 19 regions and 96 departments. Not available for past sales.",
            "items": {
              "type": "string",
              "enum": [
                "Auvergne-Rhône-Alpes",
                "01",
                "03",
                "07",
                "15",
                "26",
                "38",
                "42",
                "43",
                "63",
                "69",
                "73",
                "74",
                "Bourgogne-Franche-Comté",
                "21",
                "25",
                "39",
                "58",
                "70",
                "71",
                "89",
                "90",
                "Bretagne",
                "22",
                "29",
                "35",
                "56",
                "Centre-Val de Loire",
                "18",
                "28",
                "36",
                "37",
                "41",
                "45",
                "Corse",
                "2A",
                "2B",
                "Hauts-de-France",
                "02",
                "59",
                "60",
                "62",
                "80",
                "Île-de-France",
                "75",
                "77",
                "78",
                "91",
                "92",
                "93",
                "94",
                "95",
                "Grand Est",
                "08",
                "10",
                "51",
                "52",
                "54",
                "55",
                "57",
                "67",
                "68",
                "88",
                "Normandie",
                "14",
                "27",
                "50",
                "61",
                "76",
                "Nouvelle-Aquitaine",
                "16",
                "17",
                "19",
                "23",
                "24",
                "33",
                "40",
                "47",
                "64",
                "79",
                "86",
                "87",
                "Occitanie",
                "09",
                "11",
                "12",
                "30",
                "31",
                "32",
                "34",
                "46",
                "48",
                "65",
                "66",
                "81",
                "82",
                "Pays de la Loire",
                "44",
                "49",
                "53",
                "72",
                "85",
                "Provence-Alpes-Côte-d'Azur",
                "04",
                "05",
                "06",
                "13",
                "83",
                "84",
                "Guadeloupe",
                "Martinique",
                "Guyane",
                "La Réunion",
                "Saint-Pierre-et-Miquelon",
                "Mayotte"
              ],
              "enumTitles": [
                "Auvergne-Rhône-Alpes (region)",
                " 01 - Ain",
                " 03 - Allier",
                " 07 - Ardèche",
                " 15 - Cantal",
                " 26 - Drôme",
                " 38 - Isère",
                " 42 - Loire",
                " 43 - Haute-Loire",
                " 63 - Puy-de-Dôme",
                " 69 - Rhône",
                " 73 - Savoie",
                " 74 - Haute-Savoie",
                "Bourgogne-Franche-Comté (region)",
                " 21 - Côte d'Or",
                " 25 - Doubs",
                " 39 - Jura",
                " 58 - Nièvre",
                " 70 - Haute-Saône",
                " 71 - Saône-et-Loire",
                " 89 - Yonne",
                " 90 - Territoire de Belfort",
                "Bretagne (region)",
                " 22 - Côtes d'Armor",
                " 29 - Finistère",
                " 35 - Ille-et-Vilaine",
                " 56 - Morbihan",
                "Centre-Val de Loire (region)",
                " 18 - Cher",
                " 28 - Eure-et-Loir",
                " 36 - Indre",
                " 37 - Indre-et-Loire",
                " 41 - Loir-et-Cher",
                " 45 - Loiret",
                "Corse (region)",
                " 2A - Corse du Sud",
                " 2B - Haute-Corse",
                "Hauts-de-France (region)",
                " 02 - Aisne",
                " 59 - Nord",
                " 60 - Oise",
                " 62 - Pas-de-Calais",
                " 80 - Somme",
                "Île-de-France (region)",
                " 75 - Paris (département)",
                " 77 - Seine-et-Marne",
                " 78 - Yvelines",
                " 91 - Essonne",
                " 92 - Hauts-de-Seine",
                " 93 - Seine-Saint-Denis",
                " 94 - Val-de-Marne",
                " 95 - Val d'Oise",
                "Grand Est (region)",
                " 08 - Ardennes",
                " 10 - Aube",
                " 51 - Marne",
                " 52 - Haute-Marne",
                " 54 - Meurthe-et-Moselle",
                " 55 - Meuse",
                " 57 - Moselle",
                " 67 - Bas-Rhin",
                " 68 - Haut-Rhin",
                " 88 - Vosges",
                "Normandie (region)",
                " 14 - Calvados",
                " 27 - Eure",
                " 50 - Manche",
                " 61 - Orne",
                " 76 - Seine-Maritime",
                "Nouvelle-Aquitaine (region)",
                " 16 - Charente",
                " 17 - Charente-Maritime",
                " 19 - Corrèze",
                " 23 - Creuse",
                " 24 - Dordogne",
                " 33 - Gironde",
                " 40 - Landes",
                " 47 - Lot-et-Garonne",
                " 64 - Pyrénées-Atlantiques",
                " 79 - Deux-Sèvres",
                " 86 - Vienne",
                " 87 - Haute-Vienne",
                "Occitanie (region)",
                " 09 - Ariège",
                " 11 - Aude",
                " 12 - Aveyron",
                " 30 - Gard",
                " 31 - Haute-Garonne",
                " 32 - Gers",
                " 34 - Hérault",
                " 46 - Lot",
                " 48 - Lozère",
                " 65 - Hautes-Pyrénées",
                " 66 - Pyrénées-Orientales",
                " 81 - Tarn",
                " 82 - Tarn-et-Garonne",
                "Pays de la Loire (region)",
                " 44 - Loire-Atlantique",
                " 49 - Maine-et-Loire",
                " 53 - Mayenne",
                " 72 - Sarthe",
                " 85 - Vendée",
                "Provence-Alpes-Côte-d'Azur (region)",
                " 04 - Alpes de Haute-Provence",
                " 05 - Hautes-Alpes",
                " 06 - Alpes-Maritimes",
                " 13 - Bouches-du-Rhône",
                " 83 - Var",
                " 84 - Vaucluse",
                "Guadeloupe (region)",
                "Martinique (region)",
                "Guyane (region)",
                "La Réunion (region)",
                "Saint-Pierre-et-Miquelon (region)",
                "Mayotte (region)"
              ]
            }
          },
          "country": {
            "title": "Country",
            "enum": [
              "any",
              "FR",
              "BE",
              "CH",
              "IT",
              "MC",
              "LU",
              "ES",
              "NL",
              "DE",
              "AT",
              "IE",
              "CZ",
              "GB",
              "PL",
              "CA",
              "PT",
              "US"
            ],
            "type": "string",
            "description": "Country of the sale (houses: of the house). Not available for past sales.",
            "default": "any"
          },
          "latitude": {
            "title": "Around latitude",
            "minimum": -90,
            "maximum": 90,
            "type": "number",
            "description": "Radius search: latitude of the centre, e.g. 45.76 (Lyon). Use with longitude and radius."
          },
          "longitude": {
            "title": "Around longitude",
            "minimum": -180,
            "maximum": 180,
            "type": "number",
            "description": "Radius search: longitude of the centre, e.g. 4.84 (Lyon)."
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Radius search: distance from the centre in km. Default 50."
          },
          "saleDateFrom": {
            "title": "Sale date from",
            "type": "string",
            "description": "Only sales on or after this day (YYYY-MM-DD). Not available for auction houses."
          },
          "saleDateTo": {
            "title": "Sale date to",
            "type": "string",
            "description": "Only sales on or before this day (YYYY-MM-DD)."
          },
          "saleWithinDays": {
            "title": "Sales in the next N days",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Only sales from now to N days ahead, e.g. 7. Moves with every run, so it suits a schedule. Ignored when both dates are set."
          },
          "minEstimate": {
            "title": "Minimum estimate (EUR)",
            "minimum": 1,
            "type": "integer",
            "description": "Lots and Results: lots whose estimate reaches at least this, e.g. 500 (the site matches on the estimate range)."
          },
          "maxEstimate": {
            "title": "Maximum estimate (EUR)",
            "minimum": 1,
            "type": "integer",
            "description": "Lots and Results: lots whose estimate starts at or below this, e.g. 5000."
          },
          "auctionTypes": {
            "title": "Auction types",
            "type": "array",
            "description": "Live = sale room with live online bidding; Online = timed online sale; Classic = sale room only (absentee bids). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "live",
                "online",
                "classic"
              ],
              "enumTitles": [
                "Live (room + live bidding)",
                "Online (timed)",
                "Classic (room only)"
              ]
            }
          },
          "saleNature": {
            "title": "Sale nature",
            "enum": [
              "any",
              "voluntary",
              "judicial"
            ],
            "type": "string",
            "description": "Voluntary sales (goods entrusted by their owners) or judicial sales (court-ordered, e.g. liquidations).",
            "default": "any"
          },
          "premiumOnly": {
            "title": "Premium selection only",
            "type": "boolean",
            "description": "Only lots or sales in the site's Premium selection.",
            "default": false
          },
          "deliveryAvailable": {
            "title": "Delivery available",
            "type": "boolean",
            "description": "Only lots or sales the house can ship.",
            "default": false
          },
          "refundableVatOnly": {
            "title": "Recoverable VAT only",
            "type": "boolean",
            "description": "Lots and Results: only lots with recoverable VAT (typical of business equipment and vehicles).",
            "default": false
          },
          "keywordInDescription": {
            "title": "Keyword or lot number",
            "type": "string",
            "description": "Lots and Results: the site's \"keyword or lot no.\" box, matched in the description or the lot number, e.g. \"rolex\" or \"125\"."
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "default",
              "relevance",
              "sale-date",
              "sale-date-desc",
              "estimates",
              "estimates-desc",
              "selections",
              "newest"
            ],
            "type": "string",
            "description": "Order of the rows. Relevance needs a search term. A search bigger than the site's 10,000-result window is read in sale-date order.",
            "default": "default"
          },
          "filters": {
            "title": "More site filters (JSON)",
            "type": "object",
            "description": "Any other filter of the site's search service, by its own name, e.g. {\"fuel_type\": \"diesel\", \"mileage_range\": \"0,80000\", \"first_registration_date_range\": \"2018,2024\", \"transmission\": \"automatic\", \"organization\": \"34\"}. Overrides the form."
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Drop rows whose title or description contains any of these words, e.g. \"lot de\", \"copie\". Not case-sensitive.",
            "items": {
              "type": "string"
            }
          },
          "onlyWithImages": {
            "title": "Only lots with photos",
            "type": "boolean",
            "description": "Drop lots without a photo (9% of lots have none).",
            "default": false
          },
          "onlySold": {
            "title": "Only sold lots",
            "type": "boolean",
            "description": "Results mode: drop hammered lots that did not sell (about half of them on a measured day).",
            "default": false
          },
          "includeCompanyRegistry": {
            "title": "Company register data",
            "type": "boolean",
            "description": "Adds the French company register's record for the SIREN in the house's own VAT number: registered name, NAF code, company size, active/closed. No extra charge.",
            "default": false
          },
          "monitorMode": {
            "title": "Only new records (monitor)",
            "type": "boolean",
            "description": "Deliver only lots, sales or houses not delivered by an earlier run of the same search. Pairs with a daily schedule: Results + monitor collects every hammer price once.",
            "default": false
          },
          "monitorKey": {
            "title": "Monitor name",
            "type": "string",
            "description": "Optional name for the monitor memory, e.g. \"rolex-alert\". Empty = derived from the search, so changing the search starts a fresh memory."
          },
          "publishedSince": {
            "title": "Published since",
            "type": "string",
            "description": "Lots: only lots published after this point - a date (2026-10-01) or a duration (\"24 hours\", \"7 days\"). Reads newest first and stops at the cutoff."
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 0,
            "type": "integer",
            "description": "Most rows delivered (and charged) in this run. 0 = no cap: every lot of a search, also past the site's 10,000-result window (171,000+ upcoming lots in total).",
            "default": 100
          },
          "maxItemsPerSearch": {
            "title": "Max rows per search",
            "minimum": 0,
            "type": "integer",
            "description": "Most rows from each search term, link or id. 0 = no per-search cap.",
            "default": 0
          },
          "compact": {
            "title": "Compact rows",
            "type": "boolean",
            "description": "Core fields only (id, link, title, estimates, hammer price, sale, city, house and its contacts) - smaller rows for AI agents and spreadsheets.",
            "default": false
          },
          "includeRawData": {
            "title": "Include the site's raw record",
            "type": "boolean",
            "description": "Adds the site's own record, untouched, as \"raw\" (every field the site sends).",
            "default": false
          },
          "descriptionMaxLength": {
            "title": "Description max length",
            "minimum": 0,
            "type": "integer",
            "description": "Cut descriptions to this many characters (0 = full text; the longest measured was 3,820).",
            "default": 0
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Search pages read at the same time (1-5). Each page is up to 200 records.",
            "default": 3
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Leave as is: the actor goes direct and switches to a French residential proxy on its own when the site refuses a request (paid proxy use is capped per run). Your own proxy URLs or Apify group replace that fallback.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}