{
  "openapi": "3.0.1",
  "info": {
    "title": "Airbnb Scraper: Listings, Hosts, Business Contacts",
    "description": "Scrape Airbnb listings by location search, listing link or host, with no login. Every row carries listing_id, name, price, rating, amenities, location, host and the host business disclosure. Export JSON, CSV or Excel.",
    "version": "0.1",
    "x-build-id": "cwLlYy00EWYGr7X6m"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/herus13~airbnb-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-herus13-airbnb-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/herus13~airbnb-scraper/runs": {
      "post": {
        "operationId": "runs-sync-herus13-airbnb-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/herus13~airbnb-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-herus13-airbnb-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": {
          "queries": {
            "title": "Location searches",
            "type": "array",
            "description": "Places to search for stays, one per entry, for example `Paris, France` or `Lisbon`. Every search returns the listings Airbnb shows for the place. One search lists about 300 results at most; to go deeper the run splits the map into smaller areas and removes duplicates. Leave empty if you give listings or hosts instead; give at least one search, listing or host.",
            "items": {
              "type": "string"
            }
          },
          "listings": {
            "title": "Listing links or ids",
            "type": "array",
            "description": "Listings to read directly, one per entry, for example `https://www.airbnb.com/rooms/12345678` or `12345678`. Leave empty if you give searches or hosts instead; give at least one search, listing or host.",
            "items": {
              "type": "string"
            }
          },
          "hosts": {
            "title": "Host profile links or ids",
            "type": "array",
            "description": "Hosts whose listings you want, one per entry, for example `https://www.airbnb.com/users/show/12345678` or `12345678`. Every listing of the host is returned, up to the cap below. Leave empty if you give searches or listings instead; give at least one search, listing or host.",
            "items": {
              "type": "string"
            }
          },
          "check_in": {
            "title": "Check-in date",
            "type": "string",
            "description": "Check-in day, written as YYYY-MM-DD, for example 2026-12-20. Setting it prices every row for that stay. Must be set together with the check-out date. Leave both empty and Airbnb quotes a default stay a few weeks ahead, shown on each row. Leave empty for no dates."
          },
          "check_out": {
            "title": "Check-out date",
            "type": "string",
            "description": "Check-out day, written as YYYY-MM-DD, after the check-in date. Must be set together with the check-in date. Leave empty for no dates."
          },
          "adults": {
            "title": "Adults",
            "minimum": 1,
            "maximum": 16,
            "type": "integer",
            "description": "Number of adult guests the price is quoted for. Default 1, minimum 1, maximum 16.",
            "default": 1
          },
          "min_price": {
            "title": "Minimum price per night",
            "minimum": 0,
            "type": "integer",
            "description": "Only searches: keep stays at or above this nightly price, in the currency below. Minimum 0. Leave empty for no lower bound."
          },
          "max_price": {
            "title": "Maximum price per night",
            "minimum": 0,
            "type": "integer",
            "description": "Only searches: keep stays at or below this nightly price, in the currency below. Minimum 0. Leave empty for no upper bound."
          },
          "currency": {
            "title": "Currency",
            "enum": [
              "USD",
              "EUR",
              "GBP",
              "AUD",
              "CAD",
              "CHF",
              "JPY",
              "SGD",
              "VND"
            ],
            "type": "string",
            "description": "Currency the prices are quoted in: USD, EUR, GBP, AUD, CAD, CHF, JPY, SGD or VND. Default USD.",
            "default": "USD"
          },
          "max_listings_per_search": {
            "title": "Max listings per search",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "How many listings to return for each location search. Default 100, minimum 0, maximum 10000. Set 0 to skip the searches. One search lists about 300 results; larger values make the run split the map into smaller areas.",
            "default": 100
          },
          "max_listings_per_host": {
            "title": "Max listings per host",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "How many listings to return for each host. Default 100, minimum 0, maximum 1000. Set 0 to skip the hosts.",
            "default": 100
          },
          "include_business_contacts": {
            "title": "Include business contact details",
            "type": "boolean",
            "description": "Airbnb publishes the name, registration, email, phone and address of hosts that operate as businesses (EU and UK listings). Business name, registration and host type are always returned; turn this on to also return the email, phone and address. For sole traders these may be personal data, so you need a lawful basis to process them and are responsible for doing so under GDPR. Default false (off).",
            "default": false
          },
          "proxyUrls": {
            "title": "Your own proxy URLs (optional)",
            "type": "array",
            "description": "Leave empty: the run uses the residential proxy this actor ships with, included in the price of the run. To route the run through your own provider instead, add one gateway URL per entry, for example `http://user:pass@host:port` — works with any provider that issues URLs. When set, the run uses these first and switches to the included proxy if they stop working, so a broken proxy never fails the run.",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}