{
  "openapi": "3.0.1",
  "info": {
    "title": "Imot.bg Scraper - Bulgaria Real Estate with Phones",
    "description": "Track Bulgarian property prices, spot price drops and build agency lead lists from Imot.bg, Bulgaria's top real estate site: flats, houses, plots and offices for sale or rent, with price, m², floor, district and seller phone. Add Details for features, views, photos and full price history.",
    "version": "1.0",
    "x-build-id": "ch5u9e1EJPRYZZgPu"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/normdata~imot-bg-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-normdata-imot-bg-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/normdata~imot-bg-scraper/runs": {
      "post": {
        "operationId": "runs-sync-normdata-imot-bg-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/normdata~imot-bg-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-normdata-imot-bg-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": {
          "maxItems": {
            "title": "Maximum results",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many ads in total. Leave empty for no limit. The Apify Free plan is always capped at 10."
          },
          "dealType": {
            "title": "Sale or rent",
            "enum": [
              "sale",
              "rent"
            ],
            "type": "string",
            "description": "Properties for sale or for rent."
          },
          "propertyTypes": {
            "title": "Property types",
            "type": "array",
            "description": "Flats by number of rooms, houses, plots, offices, shops and more. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "ednostaen",
                "dvustaen",
                "tristaen",
                "chetiristaen",
                "mnogostaen",
                "mezonet",
                "atelie-tavan",
                "ofis",
                "magazin",
                "zavedenie",
                "sklad",
                "hotel",
                "promishleno-pomeshtenie",
                "etazh-ot-kashta",
                "kashta",
                "vila",
                "partsel",
                "garazh-parkomyasto",
                "zemedelska-zemya",
                "biznes-imot",
                "staya"
              ],
              "enumTitles": [
                "1-bedroom flat (studio)",
                "2-room flat (1 bedroom)",
                "3-room flat (2 bedrooms)",
                "4-room flat (3 bedrooms)",
                "Large flat (5+ rooms)",
                "Maisonette",
                "Studio / attic",
                "Office",
                "Shop",
                "Restaurant / bar",
                "Warehouse",
                "Hotel",
                "Industrial premises",
                "House floor",
                "House",
                "Villa",
                "Building plot",
                "Garage / parking",
                "Farmland",
                "Business property",
                "Room (rent only)"
              ]
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "City (the city itself) or province (the province's towns and villages outside its main city). Empty = all of Bulgaria and the Greek listings.",
            "items": {
              "type": "string",
              "enum": [
                "grad-blagoevgrad",
                "oblast-blagoevgrad",
                "grad-burgas",
                "oblast-burgas",
                "grad-dobrich",
                "oblast-dobrich",
                "grad-gabrovo",
                "oblast-gabrovo",
                "grad-haskovo",
                "oblast-haskovo",
                "grad-kardzhali",
                "oblast-kardzhali",
                "grad-kyustendil",
                "oblast-kyustendil",
                "grad-lovech",
                "oblast-lovech",
                "grad-montana",
                "oblast-montana",
                "grad-pazardzhik",
                "oblast-pazardzhik",
                "grad-pernik",
                "oblast-pernik",
                "grad-pleven",
                "oblast-pleven",
                "grad-plovdiv",
                "oblast-plovdiv",
                "grad-razgrad",
                "oblast-razgrad",
                "grad-ruse",
                "oblast-ruse",
                "grad-shumen",
                "oblast-shumen",
                "grad-silistra",
                "oblast-silistra",
                "grad-sliven",
                "oblast-sliven",
                "grad-smolyan",
                "oblast-smolyan",
                "grad-sofiya",
                "oblast-sofiya",
                "grad-stara-zagora",
                "oblast-stara-zagora",
                "grad-targovishte",
                "oblast-targovishte",
                "grad-varna",
                "oblast-varna",
                "grad-veliko-tarnovo",
                "oblast-veliko-tarnovo",
                "grad-vidin",
                "oblast-vidin",
                "grad-vratsa",
                "oblast-vratsa",
                "grad-yambol",
                "oblast-yambol",
                "gartsiya/ahaya",
                "gartsiya/argolida",
                "gartsiya/atina",
                "gartsiya/drama",
                "gartsiya/evbeya",
                "gartsiya/ftiotida",
                "gartsiya/halkidiki",
                "gartsiya/hanya",
                "gartsiya/iztochna-atika",
                "gartsiya/kavala",
                "gartsiya/kefaloniya-i-itaka",
                "gartsiya/korfu",
                "gartsiya/ksanti",
                "gartsiya/larisa",
                "gartsiya/lasiti",
                "gartsiya/levkada",
                "gartsiya/pieriya",
                "gartsiya/rodopi",
                "gartsiya/solun",
                "gartsiya/syar",
                "gartsiya/tsikladi",
                "gartsiya/zakintos"
              ],
              "enumTitles": [
                "Blagoevgrad (city)",
                "Blagoevgrad province (outside the city)",
                "Burgas (city)",
                "Burgas province (outside the city)",
                "Dobrich (city)",
                "Dobrich province (outside the city)",
                "Gabrovo (city)",
                "Gabrovo province (outside the city)",
                "Haskovo (city)",
                "Haskovo province (outside the city)",
                "Kardzhali (city)",
                "Kardzhali province (outside the city)",
                "Kyustendil (city)",
                "Kyustendil province (outside the city)",
                "Lovech (city)",
                "Lovech province (outside the city)",
                "Montana (city)",
                "Montana province (outside the city)",
                "Pazardzhik (city)",
                "Pazardzhik province (outside the city)",
                "Pernik (city)",
                "Pernik province (outside the city)",
                "Pleven (city)",
                "Pleven province (outside the city)",
                "Plovdiv (city)",
                "Plovdiv province (outside the city)",
                "Razgrad (city)",
                "Razgrad province (outside the city)",
                "Ruse (city)",
                "Ruse province (outside the city)",
                "Shumen (city)",
                "Shumen province (outside the city)",
                "Silistra (city)",
                "Silistra province (outside the city)",
                "Sliven (city)",
                "Sliven province (outside the city)",
                "Smolyan (city)",
                "Smolyan province (outside the city)",
                "Sofia (city)",
                "Sofia province (outside the city)",
                "Stara Zagora (city)",
                "Stara Zagora province (outside the city)",
                "Targovishte (city)",
                "Targovishte province (outside the city)",
                "Varna (city)",
                "Varna province (outside the city)",
                "Veliko Tarnovo (city)",
                "Veliko Tarnovo province (outside the city)",
                "Vidin (city)",
                "Vidin province (outside the city)",
                "Vratsa (city)",
                "Vratsa province (outside the city)",
                "Yambol (city)",
                "Yambol province (outside the city)",
                "Greece: Ahaya",
                "Greece: Argolida",
                "Greece: Atina",
                "Greece: Drama",
                "Greece: Evbeya",
                "Greece: Ftiotida",
                "Greece: Halkidiki",
                "Greece: Hanya",
                "Greece: Iztochna Atika",
                "Greece: Kavala",
                "Greece: Kefaloniya I Itaka",
                "Greece: Korfu",
                "Greece: Ksanti",
                "Greece: Larisa",
                "Greece: Lasiti",
                "Greece: Levkada",
                "Greece: Pieriya",
                "Greece: Rodopi",
                "Greece: Solun",
                "Greece: Syar",
                "Greece: Tsikladi",
                "Greece: Zakintos"
              ]
            }
          },
          "districts": {
            "title": "Districts",
            "type": "array",
            "description": "Districts or neighbourhoods of the cities picked, as Imot.bg writes them: Lozenets, Mladost 4, Лозенец, Център. Without locations, every city that has the district is searched.",
            "items": {
              "type": "string"
            }
          },
          "minPrice": {
            "title": "Minimum price (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Only ads from this price, in euros (rent: per month). With a price set, \"price on request\" ads are left out."
          },
          "maxPrice": {
            "title": "Maximum price (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Only ads up to this price, in euros."
          },
          "minArea": {
            "title": "Minimum area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Only properties of at least this many square meters."
          },
          "maxArea": {
            "title": "Maximum area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Only properties of at most this many square meters."
          },
          "minPricePerM2": {
            "title": "Minimum price per m² (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Only ads from this price per square meter."
          },
          "maxPricePerM2": {
            "title": "Maximum price per m² (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Only ads up to this price per square meter."
          },
          "minFloor": {
            "title": "Floor from",
            "minimum": 0,
            "type": "integer",
            "description": "Only properties on this floor or higher (ground floor = 0). Ads with no floor are left out."
          },
          "maxFloor": {
            "title": "Floor to",
            "minimum": 0,
            "type": "integer",
            "description": "Only properties on this floor or lower."
          },
          "buildStatus": {
            "title": "Building",
            "enum": [
              "all",
              "completed",
              "underConstruction"
            ],
            "type": "string",
            "description": "Completed buildings or new buildings under construction."
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "default",
              "newest",
              "price"
            ],
            "type": "string",
            "description": "Order of the results (the site's own sorting). Split searches are saved by property type, location and price instead."
          },
          "includeDetails": {
            "title": "Details",
            "type": "boolean",
            "description": "Opens each ad's own page for the full description, every phone number, construction (brick, panel…), features, price per m², yard, views, publish and edit dates, the price history (first price and every change) and all photos."
          },
          "onlyNew": {
            "title": "Only new ads",
            "type": "boolean",
            "description": "Skip ads saved by earlier runs with the same monitor name."
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Runs with the same name share their history. Use a different name for each schedule."
          },
          "startUrls": {
            "title": "Links",
            "type": "array",
            "description": "Imot.bg results pages (imot.bg/obiavi/prodazhbi/grad-sofiya/lozenets/dvustaen?price_max=200000) or ad pages (imot.bg/obiava-1b179380080517874-prodava-dvustaen-apartament-grad-sofiya-lozenets). Filters are ignored with links.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}