{
  "openapi": "3.0.1",
  "info": {
    "title": "Subito.it Scraper: Property, Cars and All Listings with Prices",
    "description": "Scrape Subito.it by keyword or search link: one row per listing with price, region, province, town, private or business seller, agency or dealer name, full description and photos, plus size, rooms and energy class for property and make, model, mileage, year and fuel for cars. No login.",
    "version": "0.1",
    "x-build-id": "SGRG5hbKI9DsXkocK"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/themineworks~subito-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-themineworks-subito-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/themineworks~subito-scraper/runs": {
      "post": {
        "operationId": "runs-sync-themineworks-subito-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/themineworks~subito-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-themineworks-subito-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": "Subito search links",
            "type": "array",
            "description": "Subito.it search result links copied from your browser, with any filters you set on the site (category, area, price, rooms, make, mileage, private sellers). Example: https://www.subito.it/annunci-lombardia/vendita/appartamenti/milano/ . Each link is one search; the pages after the first are read for you.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Keywords",
            "type": "array",
            "description": "Words to search for, as you would type them in the Subito search box, for example iphone 13, fiat panda, bilocale. Each keyword is one search and uses the filters below. Up to 100 searches per run.",
            "items": {
              "type": "string"
            }
          },
          "category": {
            "title": "Category",
            "enum": [
              "usato",
              "motori",
              "auto",
              "accessori-auto",
              "moto-e-scooter",
              "accessori-moto",
              "nautica",
              "caravan-e-camper",
              "veicoli-commerciali",
              "immobili",
              "appartamenti",
              "camere-posti-letto",
              "ville-singole-e-a-schiera",
              "terreni-e-rustici",
              "garage-e-box",
              "loft-mansarde",
              "case-vacanza",
              "uffici-locali-commerciali",
              "lavoro",
              "offerte-lavoro",
              "servizi",
              "cerco-lavoro",
              "attrezzature",
              "elettronica",
              "informatica",
              "videogiochi",
              "audio-video",
              "fotografia",
              "telefonia",
              "casa-e-persona",
              "arredamento-casalinghi",
              "elettrodomestici",
              "giardino-fai-da-te",
              "abbigliamento-accessori",
              "bambini-giocattoli",
              "sport-hobby",
              "animali",
              "accessori-per-animali",
              "musica-film",
              "libri-riviste",
              "strumenti-musicali",
              "sport",
              "biciclette",
              "hobby-collezionismo",
              "vari",
              "annunci-vari"
            ],
            "type": "string",
            "description": "Category for keyword searches. With no keyword and no link, a category together with a region or province is a search on its own (for example every car for sale in Lazio).",
            "default": "usato"
          },
          "adType": {
            "title": "Sale or rent",
            "enum": [
              "vendita",
              "affitto",
              "affitto-vacanze",
              "cerco",
              "regalo"
            ],
            "type": "string",
            "description": "For sale (vendita), for rent (affitto), holiday rent (affitto-vacanze), wanted (cerco) or for free (regalo). Rent works for property and some market categories; holiday rent for holiday homes.",
            "default": "vendita"
          },
          "region": {
            "title": "Region",
            "enum": [
              "italia",
              "piemonte",
              "valle-d-aosta",
              "lombardia",
              "trentino-alto-adige",
              "veneto",
              "friuli-venezia-giulia",
              "liguria",
              "emilia-romagna",
              "toscana",
              "umbria",
              "marche",
              "lazio",
              "abruzzo",
              "molise",
              "campania",
              "puglia",
              "basilicata",
              "calabria",
              "sicilia",
              "sardegna"
            ],
            "type": "string",
            "description": "Italian region to search in. Leave on All Italy to search everywhere or to use the province field alone.",
            "default": "italia"
          },
          "province": {
            "title": "Province",
            "type": "string",
            "description": "Optional province, by name or two letter code, for example Milano, Roma, TO, Monza. The region is filled in for you. For a single town, set it on Subito and paste the link instead."
          },
          "minPrice": {
            "title": "Min price (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price to include, in euros."
          },
          "maxPrice": {
            "title": "Max price (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price to include, in euros."
          },
          "sellerType": {
            "title": "Seller",
            "enum": [
              "all",
              "private",
              "business"
            ],
            "type": "string",
            "description": "Private sellers only, businesses only (agencies, dealers, shops), or both.",
            "default": "all"
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "datedesc",
              "relevance",
              "priceasc",
              "pricedesc"
            ],
            "type": "string",
            "description": "Order of results: newest first, most relevant, cheapest first or most expensive first.",
            "default": "datedesc"
          },
          "titleOnly": {
            "title": "Keyword in title only",
            "type": "boolean",
            "description": "On: only listings with the keyword in the title. Off: the title or the description.",
            "default": false
          },
          "shippableOnly": {
            "title": "Shippable only",
            "type": "boolean",
            "description": "On: only listings the seller ships with TuttoSubito.",
            "default": false
          },
          "maxItems": {
            "title": "Max listings per search",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "The most listings to return for each keyword or link, 1 to 5,000. A results page holds 30 listings.",
            "default": 100
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify datacenter proxy works for Subito and is the default. Residential is not needed.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}