{
  "openapi": "3.0.1",
  "info": {
    "title": "Bina.az Real Estate Scraper: Listings, Agencies, New Builds",
    "description": "Scrape Bina.az real estate in Azerbaijan: sale, rent and daily rent listings with prices, areas, rooms, coordinates and photos, plus agencies and new-build complexes with unit prices. Export CSV, Excel, JSON, XML.",
    "version": "0.1",
    "x-build-id": "SePbgvsOAJ4nxsVRs"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/recordsdata~bina-az-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-recordsdata-bina-az-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/recordsdata~bina-az-scraper/runs": {
      "post": {
        "operationId": "runs-sync-recordsdata-bina-az-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/recordsdata~bina-az-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-recordsdata-bina-az-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": {
          "recordTypes": {
            "title": "What to collect",
            "type": "array",
            "description": "Pick the kind of rows you want. Example: Listings gives one row per ad (price, area, rooms, floor, seller). Agencies, New-build complexes and Complex unit types are separate row types. Every row counts toward Max items.",
            "items": {
              "type": "string",
              "enum": [
                "listings",
                "agencies",
                "residences",
                "residence-units"
              ],
              "enumTitles": [
                "Listings (ads)",
                "Agencies",
                "New-build residential complexes",
                "Complex unit types (apartment layouts)"
              ]
            },
            "default": [
              "listings"
            ]
          },
          "operation": {
            "title": "For sale or for rent",
            "enum": [
              "sale",
              "rent",
              "daily-rent",
              "all"
            ],
            "type": "string",
            "description": "Example: For sale. Choose sale, monthly rent, daily rent, or both sale and rent. Each row says which one it is in its operation field.",
            "default": "sale"
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "How many rows to return, for example 100. Free plan: capped at 10 (preview). Paid plans: up to 1,000,000. Start small to check the result."
          },
          "startUrls": {
            "title": "bina.az links (optional)",
            "type": "array",
            "description": "Paste bina.az pages instead of using the filters: an ad (bina.az/items/6440600), an agency (bina.az/agentlikler/ideal-emlak), a new-build complex (bina.az/yasayis-kompleksleri/park-academy-living) or a search page (bina.az/baki?price_from=100000). A search link brings its own filters, so the filters below are ignored for it.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "listingIds": {
            "title": "Ad IDs or ad links (optional)",
            "type": "array",
            "description": "The number at the end of an ad URL, for example 6440600, or the full ad link. These ads are fetched directly with full detail and the filters do not apply. A removed ad returns one free error row.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "cities": {
            "title": "Cities",
            "type": "array",
            "description": "Example: Bakı, Sumqayıt, Gəncə. One city per line. Accents and capitals do not matter (Baki works). Leave empty for all cities.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Districts, metro stations, settlements",
            "type": "array",
            "description": "Example: Nərimanov r., Gənclik m., Biləcəri q. Narrows the cities above. Use the name as on bina.az, its slug (baki/nesimi) or its numeric id. A name that exists twice matches both.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "agencies": {
            "title": "Agencies",
            "type": "array",
            "description": "Example: Ideal Emlak. Only ads from these agencies, matched by name as on bina.az/agentlikler (part of the name is enough). If Record types is Agencies, returns these agency pages instead.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "propertyTypes": {
            "title": "Property types",
            "type": "array",
            "description": "Example: Apartment, new build. Leave empty for all seven types. Apartments are split the way the site splits them: new-build and resale.",
            "items": {
              "type": "string",
              "enum": [
                "new-build-apartment",
                "resale-apartment",
                "house",
                "office",
                "garage",
                "land",
                "commercial"
              ],
              "enumTitles": [
                "Apartment, new build",
                "Apartment, resale",
                "House / garden house",
                "Office",
                "Garage",
                "Land",
                "Commercial property"
              ]
            },
            "default": []
          },
          "buildingType": {
            "title": "Building type",
            "enum": [
              "any",
              "apartment",
              "villa",
              "business-center"
            ],
            "type": "string",
            "description": "Example: Apartment building. Choose apartment building, villa or business center (offices). Any keeps all.",
            "default": "any"
          },
          "rooms": {
            "title": "Number of rooms",
            "type": "array",
            "description": "Example: 2 and 3. Exactly these room counts; bina.az counts every room, living room included. Leave empty for any.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "8",
                "9",
                "10"
              ],
              "enumTitles": [
                "1 room",
                "2 rooms",
                "3 rooms",
                "4 rooms",
                "5 rooms",
                "6 rooms",
                "7 rooms",
                "8 rooms",
                "9 rooms",
                "10 rooms"
              ]
            },
            "default": []
          },
          "minPrice": {
            "title": "Minimum price (AZN)",
            "minimum": 0,
            "type": "integer",
            "description": "Example: 50000. In Azerbaijani manat. For rent it is the monthly (or daily) rent. 0 means no minimum.",
            "default": 0
          },
          "maxPrice": {
            "title": "Maximum price (AZN)",
            "minimum": 0,
            "type": "integer",
            "description": "Example: 150000. In Azerbaijani manat. 0 means no maximum.",
            "default": 0
          },
          "minArea": {
            "title": "Minimum area (m2)",
            "minimum": 0,
            "type": "integer",
            "description": "Example: 60. Living or built area in square meters. For land plots it is the plot size, rounded to whole sot (1 sot = 100 m2). 0 means no minimum.",
            "default": 0
          },
          "maxArea": {
            "title": "Maximum area (m2)",
            "minimum": 0,
            "type": "integer",
            "description": "Example: 120. Same rules as minimum area. 0 means no maximum.",
            "default": 0
          },
          "minLandArea": {
            "title": "Minimum land area (sot)",
            "minimum": 0,
            "type": "integer",
            "description": "Example: 5. In sot (1 sot = 100 m2). For houses it is the plot around the house, for land the plot itself. 0 means no minimum.",
            "default": 0
          },
          "maxLandArea": {
            "title": "Maximum land area (sot)",
            "minimum": 0,
            "type": "integer",
            "description": "Example: 20. Same rules as minimum land area. 0 means no maximum.",
            "default": 0
          },
          "minFloor": {
            "title": "Minimum floor",
            "minimum": 0,
            "type": "integer",
            "description": "Example: 3. Apartments on this floor or higher. 0 means no minimum.",
            "default": 0
          },
          "maxFloor": {
            "title": "Maximum floor",
            "minimum": 0,
            "type": "integer",
            "description": "Example: 9. Apartments on this floor or lower. 0 means no maximum.",
            "default": 0
          },
          "floorPosition": {
            "title": "Floor position",
            "enum": [
              "any",
              "not-first",
              "not-last",
              "not-first-or-last",
              "first-only",
              "last-only"
            ],
            "type": "string",
            "description": "Example: Not the first floor. Keep or drop the ground and top floors of the building.",
            "default": "any"
          },
          "onlyTitleDeed": {
            "title": "Only with title deed (kupça)",
            "type": "boolean",
            "description": "Turn on to keep only ads that state a registered title deed.",
            "default": false
          },
          "onlyMortgage": {
            "title": "Only mortgage-eligible",
            "type": "boolean",
            "description": "Turn on to keep only ads where the seller says a bank mortgage is possible.",
            "default": false
          },
          "onlyDeveloperFinancing": {
            "title": "Only with developer financing",
            "type": "boolean",
            "description": "Turn on to keep only ads that offer an internal loan or installment plan from the developer.",
            "default": false
          },
          "onlyRenovated": {
            "title": "Only renovated (təmirli)",
            "type": "boolean",
            "description": "Turn on to keep only ads marked as renovated.",
            "default": false
          },
          "onlyNewBuildComplexes": {
            "title": "Only from new-build complexes",
            "type": "boolean",
            "description": "Turn on to keep only ads that belong to a registered new-build residential complex.",
            "default": false
          },
          "listingTier": {
            "title": "Promoted ads",
            "enum": [
              "any",
              "featured",
              "premium"
            ],
            "type": "string",
            "description": "Example: All ads. Keep only ads the seller paid to promote: featured (highlighted) or premium (VIP, pinned to the top).",
            "default": "any"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "newest",
              "priceAsc",
              "priceDesc",
              "areaAsc",
              "areaDesc",
              "pricePerSotAsc",
              "pricePerSotDesc"
            ],
            "type": "string",
            "description": "Order of the ads inside every search. Newest first means last updated or renewed first.",
            "default": "newest"
          },
          "updatedSince": {
            "title": "Updated since (date)",
            "type": "string",
            "description": "Example: 2026-10-10 or 2026-10-10T08:00:00+04:00 (Baku time is UTC+4). Only ads updated on or after this date. Leave empty for no cutoff. With newest-first sort the scan stops early.",
            "default": ""
          },
          "fetchDetails": {
            "title": "Fetch full ad details",
            "type": "boolean",
            "description": "Adds the full description, street address, coordinates, all photos, views, contact type and the agency or developer. Billed as the listing-detail event on top of each listing. Turn off for a cheaper list-only run.",
            "default": true
          },
          "includeContactDetails": {
            "title": "Include business contact data",
            "type": "boolean",
            "description": "Adds contact data sellers wrote in public text: developer website and e-mail of a complex, phones or e-mails in agency and developer descriptions. Private sellers contacts are always removed. Off by default.",
            "default": false
          },
          "onlyNew": {
            "title": "Only new rows (monitor mode)",
            "type": "boolean",
            "description": "Skips every row this same search returned in an earlier run, so a scheduled run returns only new ones and you are not charged for skipped rows. Max items then means N new rows. Off by default.",
            "default": false
          },
          "stateKey": {
            "title": "Monitor name (optional)",
            "type": "string",
            "description": "Example: baku-2rooms. Name of this monitor; leave empty to derive it from your filters. Use a name to run two monitors with the same filters.",
            "default": ""
          },
          "resetSeen": {
            "title": "Forget previously seen rows",
            "type": "boolean",
            "description": "Clears the saved list for this monitor before the run, so everything counts as new again.",
            "default": false
          },
          "maxRunSeconds": {
            "title": "Max run time (seconds)",
            "minimum": 30,
            "maximum": 86400,
            "type": "integer",
            "description": "Safety stop: after this many seconds the run ends and returns what was gathered, so a very wide search never runs unbounded. Default 1800 (30 minutes).",
            "default": 1800
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}