@crawlora-org/sdk 1.9.0-sdk.1 → 1.10.0-sdk.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## v1.10.0-sdk.1
+
+- Regenerated from the public API contract (525 to 529 operations). Adds the
+  **Airbnb Markets dataset** (4 endpoints): aggregate short-term-rental market
+  statistics -- listing supply, Superhost share, ratings, and nightly-price bands
+  -- rolled up by country, metro, and geo cell (search, item lookup, facets, and
+  nearby density). Aggregate-only: no individual listings or hosts.
+
 ## v1.9.0-sdk.1
 
 - Regenerated from the public API contract (499 to 525 operations). Adds four

package/docs/operations.md

@@ -2,7 +2,7 @@
 
 Generated from `openapi/public.json`. Deprecated, admin, and internal operations are excluded from this SDK contract.
 
-Total operations: `525`
+Total operations: `529`
 
 | Group | SDK method | Operation ID | HTTP | Params | Auth | Response | Notes |
 | --- | --- | --- | --- | --- | --- | --- | --- |
@@ -93,6 +93,10 @@ Total operations: `525`
 | web | `web.antibotCheck` | `antibot-check` | `POST /diagnostics/antibot-check` | `request` (body string required) | `ApiKeyAuth` | `WebAntibotCheckResponse` |  |
 | web | `web.scrape` | `web-scrape` | `POST /web/scrape` | `scrapeOption` (body string required) | `ApiKeyAuth` | `WebScrapeResponse` |  |
 | datasets | `datasets.list` | `datasets-list` | `GET /datasets` | none | `ApiKeyAuth` | `DatasetsListResponse` |  |
+| datasets | `datasets.airbnbMarketsFacets` | `datasets-airbnb-markets-facets` | `GET /datasets/airbnb-markets/facets` | `facet` (query string required)<br>`group_by` (query string)<br>`country` (query string)<br>`market` (query string)<br>`superhost` (query boolean)<br>`min_rating` (query number)<br>`min_review_count` (query number)<br>`active_since` (query string)<br>`min_listings` (query number) | `ApiKeyAuth` | `DatasetsAirbnbMarketsFacetsResponse` |  |
+| datasets | `datasets.airbnbMarketsItem` | `datasets-airbnb-markets-item` | `GET /datasets/airbnb-markets/items/{country}` | `country` (path string required) | `ApiKeyAuth` | `DatasetsAirbnbMarketsItemResponse` |  |
+| datasets | `datasets.airbnbMarketsNearby` | `datasets-airbnb-markets-nearby` | `GET /datasets/airbnb-markets/nearby` | `lat` (query number required)<br>`lon` (query number required)<br>`radius_m` (query number required)<br>`precision` (query number)<br>`min_listings` (query number)<br>`country` (query string)<br>`superhost` (query boolean)<br>`min_rating` (query number)<br>`active_since` (query string) | `ApiKeyAuth` | `DatasetsAirbnbMarketsNearbyResponse` |  |
+| datasets | `datasets.airbnbMarketsSearch` | `datasets-airbnb-markets-search` | `GET /datasets/airbnb-markets/search` | `group_by` (query string)<br>`country` (query string)<br>`market` (query string)<br>`superhost` (query boolean)<br>`min_rating` (query number)<br>`min_review_count` (query number)<br>`active_since` (query string)<br>`min_listings` (query number)<br>`sort` (query string)<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsAirbnbMarketsSearchResponse` |  |
 | datasets | `datasets.appsChartsSearch` | `datasets-apps-charts-search` | `GET /datasets/apps-charts/search` | `q` (query string)<br>`store` (query string)<br>`chart_type` (query string)<br>`collection` (query string)<br>`category` (query string)<br>`country` (query string)<br>`app_id` (query string)<br>`date` (query string)<br>`sort` (query string)<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsAppsChartsSearchResponse` |  |
 | datasets | `datasets.appsReviewsSearch` | `datasets-apps-reviews-search` | `GET /datasets/apps-reviews/search` | `q` (query string)<br>`store` (query string)<br>`app_id` (query string)<br>`country` (query string)<br>`min_score` (query number)<br>`sort` (query string)<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsAppsReviewsSearchResponse` |  |
 | datasets | `datasets.appsSearch` | `datasets-apps-search` | `GET /datasets/apps/search` | `q` (query string)<br>`store` (query string)<br>`category` (query string)<br>`country` (query string)<br>`developer` (query string)<br>`free` (query boolean)<br>`min_rating` (query number)<br>`min_reviews` (query number)<br>`sort` (query string)<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsAppsSearchResponse` |  |

package/openapi/public.json

@@ -8479,6 +8479,84 @@
       },
       "type": "object"
     },
+    "datasets.AirbnbMarketFacetResponse": {
+      "properties": {
+        "dataset": {
+          "type": "string"
+        },
+        "facet": {
+          "type": "string"
+        },
+        "items": {
+          "items": {
+            "$ref": "#/definitions/es.AirbnbMarketFacetItem"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "datasets.AirbnbMarketNearbyResponse": {
+      "properties": {
+        "cells": {
+          "items": {
+            "$ref": "#/definitions/es.AirbnbDensityCell"
+          },
+          "type": "array"
+        },
+        "dataset": {
+          "type": "string"
+        },
+        "lat": {
+          "type": "number"
+        },
+        "lon": {
+          "type": "number"
+        },
+        "precision": {
+          "type": "integer"
+        },
+        "radius_m": {
+          "type": "integer"
+        },
+        "total": {
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "datasets.AirbnbMarketSearchResponse": {
+      "properties": {
+        "dataset": {
+          "type": "string"
+        },
+        "group_by": {
+          "type": "string"
+        },
+        "items": {
+          "items": {
+            "$ref": "#/definitions/es.AirbnbMarketCell"
+          },
+          "type": "array"
+        },
+        "min_listings": {
+          "type": "integer"
+        },
+        "page": {
+          "type": "integer"
+        },
+        "page_size": {
+          "type": "integer"
+        },
+        "sort": {
+          "type": "string"
+        },
+        "total": {
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
     "datasets.AppsSearchResponse": {
       "properties": {
         "dataset": {
@@ -8703,6 +8781,70 @@
       },
       "type": "object"
     },
+    "datasets.airbnbMarketResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/es.AirbnbMarketDetail"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "datasets.airbnbMarketsFacetResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/datasets.AirbnbMarketFacetResponse"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "datasets.airbnbMarketsNearbyResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/datasets.AirbnbMarketNearbyResponse"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "datasets.airbnbMarketsSearchResponseDoc": {
+      "properties": {
+        "code": {
+          "example": 200,
+          "type": "integer"
+        },
+        "data": {
+          "$ref": "#/definitions/datasets.AirbnbMarketSearchResponse"
+        },
+        "msg": {
+          "example": "OK",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "datasets.appsSearchResponseDoc": {
       "properties": {
         "code": {
@@ -9538,6 +9680,144 @@
       },
       "type": "object"
     },
+    "es.AirbnbDensityCell": {
+      "properties": {
+        "geohash": {
+          "type": "string"
+        },
+        "lat": {
+          "type": "number"
+        },
+        "listings": {
+          "type": "integer"
+        },
+        "lon": {
+          "type": "number"
+        },
+        "superhost_listings": {
+          "type": "integer"
+        },
+        "superhost_pct": {
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "es.AirbnbGeoBounds": {
+      "properties": {
+        "bottom_right": {
+          "$ref": "#/definitions/es.GeoPoint"
+        },
+        "top_left": {
+          "$ref": "#/definitions/es.GeoPoint"
+        }
+      },
+      "type": "object"
+    },
+    "es.AirbnbMarketCell": {
+      "properties": {
+        "avg_rating": {
+          "type": "number"
+        },
+        "avg_review_count": {
+          "type": "number"
+        },
+        "key": {
+          "type": "string"
+        },
+        "last_seen": {
+          "type": "string"
+        },
+        "listings": {
+          "type": "integer"
+        },
+        "rated_listings": {
+          "type": "integer"
+        },
+        "superhost_listings": {
+          "type": "integer"
+        },
+        "superhost_pct": {
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "es.AirbnbMarketDetail": {
+      "properties": {
+        "avg_rating": {
+          "type": "number"
+        },
+        "avg_review_count": {
+          "type": "number"
+        },
+        "bounds": {
+          "$ref": "#/definitions/es.AirbnbGeoBounds"
+        },
+        "country": {
+          "type": "string"
+        },
+        "currencies": {
+          "items": {
+            "$ref": "#/definitions/es.AirbnbPriceStats"
+          },
+          "type": "array"
+        },
+        "last_seen": {
+          "type": "string"
+        },
+        "listings": {
+          "type": "integer"
+        },
+        "metros": {
+          "items": {
+            "$ref": "#/definitions/es.AirbnbMarketCell"
+          },
+          "type": "array"
+        },
+        "rated_listings": {
+          "type": "integer"
+        },
+        "superhost_listings": {
+          "type": "integer"
+        },
+        "superhost_pct": {
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "es.AirbnbMarketFacetItem": {
+      "properties": {
+        "count": {
+          "type": "integer"
+        },
+        "value": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "es.AirbnbPriceStats": {
+      "properties": {
+        "currency": {
+          "type": "string"
+        },
+        "listings": {
+          "type": "integer"
+        },
+        "p25": {
+          "type": "number"
+        },
+        "p50": {
+          "type": "number"
+        },
+        "p75": {
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
     "es.AppRecord": {
       "properties": {
         "android_max_installs": {
@@ -48059,6 +48339,393 @@
         ]
       }
     },
+    "/datasets/airbnb-markets/facets": {
+      "get": {
+        "consumes": [
+          "application/json"
+        ],
+        "description": "Returns suppressed distribution counts over the Airbnb markets dataset, honoring the same filters as search. Facet enum: `country`, `market`, `currency`, `superhost`, `rating_band`, `review_band`. group_by enum: `country`, `market`.",
+        "operationId": "datasets-airbnb-markets-facets",
+        "parameters": [
+          {
+            "description": "Facet enum: country, market, currency, superhost, rating_band, review_band",
+            "in": "query",
+            "name": "facet",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "description": "Aggregate cell dimension enum: country, market. Defaults to country",
+            "in": "query",
+            "name": "group_by",
+            "type": "string"
+          },
+          {
+            "description": "Exact ISO-3166-1 alpha-2 country filter, e.g. FR",
+            "in": "query",
+            "name": "country",
+            "type": "string"
+          },
+          {
+            "description": "Exact metro-market filter, max 128 characters",
+            "in": "query",
+            "name": "market",
+            "type": "string"
+          },
+          {
+            "description": "Count only Superhost listings",
+            "in": "query",
+            "name": "superhost",
+            "type": "boolean"
+          },
+          {
+            "description": "Minimum listing rating, from 0 through 5",
+            "in": "query",
+            "name": "min_rating",
+            "type": "number"
+          },
+          {
+            "description": "Minimum listing review count, 0 or greater",
+            "in": "query",
+            "name": "min_review_count",
+            "type": "integer"
+          },
+          {
+            "description": "Freshness filter, an ISO-8601 date (YYYY-MM-DD)",
+            "in": "query",
+            "name": "active_since",
+            "type": "string"
+          },
+          {
+            "description": "Minimum listings per bucket; raises the small-cell suppression floor",
+            "in": "query",
+            "name": "min_listings",
+            "type": "integer"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/datasets.airbnbMarketsFacetResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "429": {
+            "description": "Too Many Requests",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "500": {
+            "description": "Internal Server Error",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Facet the Airbnb markets dataset",
+        "tags": [
+          "Datasets"
+        ]
+      }
+    },
+    "/datasets/airbnb-markets/items/{country}": {
+      "get": {
+        "consumes": [
+          "application/json"
+        ],
+        "description": "Returns one country's full aggregate Airbnb market profile from dataset id enum value `airbnb-markets` — headline supply, Superhost share, ratings, its top metros, bounding box and per-currency nightly-price percentiles. Aggregate-only. Returns 404 for a country below the suppression floor.",
+        "operationId": "datasets-airbnb-markets-item",
+        "parameters": [
+          {
+            "description": "ISO-3166-1 alpha-2 country code, e.g. FR",
+            "in": "path",
+            "name": "country",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/datasets.airbnbMarketResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "429": {
+            "description": "Too Many Requests",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "500": {
+            "description": "Internal Server Error",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Get an Airbnb market from the dataset",
+        "tags": [
+          "Datasets"
+        ]
+      }
+    },
+    "/datasets/airbnb-markets/nearby": {
+      "get": {
+        "consumes": [
+          "application/json"
+        ],
+        "description": "Returns an aggregate geohash-grid density map of Airbnb listings within a radius of a coordinate, from dataset id enum value `airbnb-markets`. Each cell reports a centroid, listing count and Superhost share; thin cells are suppressed. Aggregate-only.",
+        "operationId": "datasets-airbnb-markets-nearby",
+        "parameters": [
+          {
+            "description": "Center latitude, from -90 through 90",
+            "in": "query",
+            "name": "lat",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "description": "Center longitude, from -180 through 180",
+            "in": "query",
+            "name": "lon",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "description": "Search radius in meters, from 1 through 50000",
+            "in": "query",
+            "name": "radius_m",
+            "required": true,
+            "type": "integer"
+          },
+          {
+            "description": "Geohash precision, from 1 through 12; defaults to a value derived from the radius",
+            "in": "query",
+            "name": "precision",
+            "type": "integer"
+          },
+          {
+            "description": "Minimum listings per cell; raises the small-cell suppression floor",
+            "in": "query",
+            "name": "min_listings",
+            "type": "integer"
+          },
+          {
+            "description": "Exact ISO-3166-1 alpha-2 country filter, e.g. US",
+            "in": "query",
+            "name": "country",
+            "type": "string"
+          },
+          {
+            "description": "Count only Superhost listings",
+            "in": "query",
+            "name": "superhost",
+            "type": "boolean"
+          },
+          {
+            "description": "Minimum listing rating, from 0 through 5",
+            "in": "query",
+            "name": "min_rating",
+            "type": "number"
+          },
+          {
+            "description": "Freshness filter, an ISO-8601 date (YYYY-MM-DD)",
+            "in": "query",
+            "name": "active_since",
+            "type": "string"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/datasets.airbnbMarketsNearbyResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "429": {
+            "description": "Too Many Requests",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "500": {
+            "description": "Internal Server Error",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Airbnb market density near a coordinate",
+        "tags": [
+          "Datasets"
+        ]
+      }
+    },
+    "/datasets/airbnb-markets/search": {
+      "get": {
+        "consumes": [
+          "application/json"
+        ],
+        "description": "Returns aggregate Airbnb short-term-rental market rollups from the dataset id enum value `airbnb-markets`. Aggregate-only: each row is a market cell (a country or a metro), never an individual listing. Thin cells are suppressed. group_by enum: `country`, `market`. Sort enum: `listings_desc`, `superhost_pct_desc`, `rating_desc`, `key_asc`.",
+        "operationId": "datasets-airbnb-markets-search",
+        "parameters": [
+          {
+            "description": "Aggregate cell dimension enum: country, market. Defaults to country",
+            "in": "query",
+            "name": "group_by",
+            "type": "string"
+          },
+          {
+            "description": "Exact ISO-3166-1 alpha-2 country filter, e.g. FR",
+            "in": "query",
+            "name": "country",
+            "type": "string"
+          },
+          {
+            "description": "Exact metro-market filter, e.g. Paris, max 128 characters",
+            "in": "query",
+            "name": "market",
+            "type": "string"
+          },
+          {
+            "description": "Count only Superhost listings",
+            "in": "query",
+            "name": "superhost",
+            "type": "boolean"
+          },
+          {
+            "description": "Minimum listing rating, from 0 through 5",
+            "in": "query",
+            "name": "min_rating",
+            "type": "number"
+          },
+          {
+            "description": "Minimum listing review count, 0 or greater",
+            "in": "query",
+            "name": "min_review_count",
+            "type": "integer"
+          },
+          {
+            "description": "Freshness filter, an ISO-8601 date (YYYY-MM-DD); only listings last seen on or after it are counted",
+            "in": "query",
+            "name": "active_since",
+            "type": "string"
+          },
+          {
+            "description": "Minimum listings per cell; raises the small-cell suppression floor (never lowered below the built-in minimum)",
+            "in": "query",
+            "name": "min_listings",
+            "type": "integer"
+          },
+          {
+            "description": "Sort enum: listings_desc, superhost_pct_desc, rating_desc, key_asc",
+            "in": "query",
+            "name": "sort",
+            "type": "string"
+          },
+          {
+            "description": "Page number, defaults to 1",
+            "in": "query",
+            "name": "page",
+            "type": "integer"
+          },
+          {
+            "description": "Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000",
+            "in": "query",
+            "name": "page_size",
+            "type": "integer"
+          }
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/datasets.airbnbMarketsSearchResponseDoc"
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "429": {
+            "description": "Too Many Requests",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          },
+          "500": {
+            "description": "Internal Server Error",
+            "schema": {
+              "$ref": "#/definitions/app.Response"
+            }
+          }
+        },
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "summary": "Search the Airbnb markets dataset",
+        "tags": [
+          "Datasets"
+        ]
+      }
+    },
     "/datasets/apps-charts/search": {
       "get": {
         "consumes": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crawlora-org/sdk",
-  "version": "1.9.0-sdk.1",
+  "version": "1.10.0-sdk.1",
   "description": "JavaScript and TypeScript SDK for the public Crawlora API.",
   "keywords": [
     "crawlora",

package/src/client.js

@@ -1,7 +1,7 @@
 import { operations, groups } from "./operations.js";
 
 const DEFAULT_BASE_URL = "https://api.crawlora.net/api/v1";
-export const VERSION = "1.9.0-sdk.1";
+export const VERSION = "1.10.0-sdk.1";
 const DEFAULT_USER_AGENT = `crawlora-js-sdk/${VERSION}`;
 
 export class CrawloraError extends Error {

package/src/operations.js

@@ -4270,6 +4270,237 @@ export const operations = {
       "ApiKeyAuth"
     ]
   },
+  "datasets-airbnb-markets-facets": {
+    "bodyParam": null,
+    "bodyRequired": false,
+    "consumes": [
+      "application/json"
+    ],
+    "formParams": [],
+    "id": "datasets-airbnb-markets-facets",
+    "method": "GET",
+    "path": "/datasets/airbnb-markets/facets",
+    "pathParams": [],
+    "produces": [
+      "application/json"
+    ],
+    "queryParams": [
+      {
+        "in": "query",
+        "name": "facet",
+        "required": true,
+        "type": "string"
+      },
+      {
+        "in": "query",
+        "name": "group_by",
+        "type": "string"
+      },
+      {
+        "in": "query",
+        "name": "country",
+        "type": "string"
+      },
+      {
+        "in": "query",
+        "name": "market",
+        "type": "string"
+      },
+      {
+        "in": "query",
+        "name": "superhost",
+        "type": "boolean"
+      },
+      {
+        "in": "query",
+        "name": "min_rating",
+        "type": "number"
+      },
+      {
+        "in": "query",
+        "name": "min_review_count",
+        "type": "integer"
+      },
+      {
+        "in": "query",
+        "name": "active_since",
+        "type": "string"
+      },
+      {
+        "in": "query",
+        "name": "min_listings",
+        "type": "integer"
+      }
+    ],
+    "security": [
+      "ApiKeyAuth"
+    ]
+  },
+  "datasets-airbnb-markets-item": {
+    "bodyParam": null,
+    "bodyRequired": false,
+    "consumes": [
+      "application/json"
+    ],
+    "formParams": [],
+    "id": "datasets-airbnb-markets-item",
+    "method": "GET",
+    "path": "/datasets/airbnb-markets/items/{country}",
+    "pathParams": [
+      "country"
+    ],
+    "produces": [
+      "application/json"
+    ],
+    "queryParams": [],
+    "security": [
+      "ApiKeyAuth"
+    ]
+  },
+  "datasets-airbnb-markets-nearby": {
+    "bodyParam": null,
+    "bodyRequired": false,
+    "consumes": [
+      "application/json"
+    ],
+    "formParams": [],
+    "id": "datasets-airbnb-markets-nearby",
+    "method": "GET",
+    "path": "/datasets/airbnb-markets/nearby",
+    "pathParams": [],
+    "produces": [
+      "application/json"
+    ],
+    "queryParams": [
+      {
+        "in": "query",
+        "name": "lat",
+        "required": true,
+        "type": "number"
+      },
+      {
+        "in": "query",
+        "name": "lon",
+        "required": true,
+        "type": "number"
+      },
+      {
+        "in": "query",
+        "name": "radius_m",
+        "required": true,
+        "type": "integer"
+      },
+      {
+        "in": "query",
+        "name": "precision",
+        "type": "integer"
+      },
+      {
+        "in": "query",
+        "name": "min_listings",
+        "type": "integer"
+      },
+      {
+        "in": "query",
+        "name": "country",
+        "type": "string"
+      },
+      {
+        "in": "query",
+        "name": "superhost",
+        "type": "boolean"
+      },
+      {
+        "in": "query",
+        "name": "min_rating",
+        "type": "number"
+      },
+      {
+        "in": "query",
+        "name": "active_since",
+        "type": "string"
+      }
+    ],
+    "security": [
+      "ApiKeyAuth"
+    ]
+  },
+  "datasets-airbnb-markets-search": {
+    "bodyParam": null,
+    "bodyRequired": false,
+    "consumes": [
+      "application/json"
+    ],
+    "formParams": [],
+    "id": "datasets-airbnb-markets-search",
+    "method": "GET",
+    "paginatable": true,
+    "path": "/datasets/airbnb-markets/search",
+    "pathParams": [],
+    "produces": [
+      "application/json"
+    ],
+    "queryParams": [
+      {
+        "in": "query",
+        "name": "group_by",
+        "type": "string"
+      },
+      {
+        "in": "query",
+        "name": "country",
+        "type": "string"
+      },
+      {
+        "in": "query",
+        "name": "market",
+        "type": "string"
+      },
+      {
+        "in": "query",
+        "name": "superhost",
+        "type": "boolean"
+      },
+      {
+        "in": "query",
+        "name": "min_rating",
+        "type": "number"
+      },
+      {
+        "in": "query",
+        "name": "min_review_count",
+        "type": "integer"
+      },
+      {
+        "in": "query",
+        "name": "active_since",
+        "type": "string"
+      },
+      {
+        "in": "query",
+        "name": "min_listings",
+        "type": "integer"
+      },
+      {
+        "in": "query",
+        "name": "sort",
+        "type": "string"
+      },
+      {
+        "in": "query",
+        "name": "page",
+        "type": "integer"
+      },
+      {
+        "in": "query",
+        "name": "page_size",
+        "type": "integer"
+      }
+    ],
+    "security": [
+      "ApiKeyAuth"
+    ]
+  },
   "datasets-apps-charts-search": {
     "bodyParam": null,
     "bodyRequired": false,
@@ -20359,6 +20590,10 @@ export const groups = {
     "trending": "coingecko-trending"
   },
   "datasets": {
+    "airbnbMarketsFacets": "datasets-airbnb-markets-facets",
+    "airbnbMarketsItem": "datasets-airbnb-markets-item",
+    "airbnbMarketsNearby": "datasets-airbnb-markets-nearby",
+    "airbnbMarketsSearch": "datasets-airbnb-markets-search",
     "appsChartsSearch": "datasets-apps-charts-search",
     "appsReviewsSearch": "datasets-apps-reviews-search",
     "appsSearch": "datasets-apps-search",
@@ -20870,7 +21105,7 @@ export const groups = {
   }
 };
 
-export const operationCount = 525;
+export const operationCount = 529;
 
 // PascalCase aliases for every operation id, for discoverable, typo-safe
 // dynamic calls: client.request(OperationIds.BingSearch, { q: "coffee" }).
@@ -20958,6 +21193,10 @@ export const OperationIds = Object.freeze({
   "CoinGeckoTokenUnlocks": "coingecko-token-unlocks",
   "CoinGeckoTreasuries": "coingecko-treasuries",
   "CoinGeckoTrending": "coingecko-trending",
+  "DatasetsAirbnbMarketsFacets": "datasets-airbnb-markets-facets",
+  "DatasetsAirbnbMarketsItem": "datasets-airbnb-markets-item",
+  "DatasetsAirbnbMarketsNearby": "datasets-airbnb-markets-nearby",
+  "DatasetsAirbnbMarketsSearch": "datasets-airbnb-markets-search",
   "DatasetsAppsChartsSearch": "datasets-apps-charts-search",
   "DatasetsAppsReviewsSearch": "datasets-apps-reviews-search",
   "DatasetsAppsSearch": "datasets-apps-search",

package/src/types.d.ts

@@ -2565,6 +2565,33 @@ export interface ModelContactContactResponseDoc {
   "msg"?: string;
 }
 
+export interface ModelDatasetsAirbnbMarketFacetResponse {
+  "dataset"?: string;
+  "facet"?: string;
+  "items"?: Array<ModelEsAirbnbMarketFacetItem>;
+}
+
+export interface ModelDatasetsAirbnbMarketNearbyResponse {
+  "cells"?: Array<ModelEsAirbnbDensityCell>;
+  "dataset"?: string;
+  "lat"?: number;
+  "lon"?: number;
+  "precision"?: number;
+  "radius_m"?: number;
+  "total"?: number;
+}
+
+export interface ModelDatasetsAirbnbMarketSearchResponse {
+  "dataset"?: string;
+  "group_by"?: string;
+  "items"?: Array<ModelEsAirbnbMarketCell>;
+  "min_listings"?: number;
+  "page"?: number;
+  "page_size"?: number;
+  "sort"?: string;
+  "total"?: number;
+}
+
 export interface ModelDatasetsAppsSearchResponse {
   "dataset"?: string;
   "items"?: Array<ModelEsAppRecord>;
@@ -2643,6 +2670,30 @@ export interface ModelDatasetsReviewsSearchResponse {
   "total"?: number;
 }
 
+export interface ModelDatasetsAirbnbMarketResponseDoc {
+  "code"?: number;
+  "data"?: ModelEsAirbnbMarketDetail;
+  "msg"?: string;
+}
+
+export interface ModelDatasetsAirbnbMarketsFacetResponseDoc {
+  "code"?: number;
+  "data"?: ModelDatasetsAirbnbMarketFacetResponse;
+  "msg"?: string;
+}
+
+export interface ModelDatasetsAirbnbMarketsNearbyResponseDoc {
+  "code"?: number;
+  "data"?: ModelDatasetsAirbnbMarketNearbyResponse;
+  "msg"?: string;
+}
+
+export interface ModelDatasetsAirbnbMarketsSearchResponseDoc {
+  "code"?: number;
+  "data"?: ModelDatasetsAirbnbMarketSearchResponse;
+  "msg"?: string;
+}
+
 export interface ModelDatasetsAppsSearchResponseDoc {
   "code"?: number;
   "data"?: ModelDatasetsAppsSearchResponse;
@@ -2897,6 +2948,58 @@ export interface ModelEbaySellerShopResponseDoc {
   "msg"?: unknown;
 }
 
+export interface ModelEsAirbnbDensityCell {
+  "geohash"?: string;
+  "lat"?: number;
+  "listings"?: number;
+  "lon"?: number;
+  "superhost_listings"?: number;
+  "superhost_pct"?: number;
+}
+
+export interface ModelEsAirbnbGeoBounds {
+  "bottom_right"?: ModelEsGeoPoint;
+  "top_left"?: ModelEsGeoPoint;
+}
+
+export interface ModelEsAirbnbMarketCell {
+  "avg_rating"?: number;
+  "avg_review_count"?: number;
+  "key"?: string;
+  "last_seen"?: string;
+  "listings"?: number;
+  "rated_listings"?: number;
+  "superhost_listings"?: number;
+  "superhost_pct"?: number;
+}
+
+export interface ModelEsAirbnbMarketDetail {
+  "avg_rating"?: number;
+  "avg_review_count"?: number;
+  "bounds"?: ModelEsAirbnbGeoBounds;
+  "country"?: string;
+  "currencies"?: Array<ModelEsAirbnbPriceStats>;
+  "last_seen"?: string;
+  "listings"?: number;
+  "metros"?: Array<ModelEsAirbnbMarketCell>;
+  "rated_listings"?: number;
+  "superhost_listings"?: number;
+  "superhost_pct"?: number;
+}
+
+export interface ModelEsAirbnbMarketFacetItem {
+  "count"?: number;
+  "value"?: string;
+}
+
+export interface ModelEsAirbnbPriceStats {
+  "currency"?: string;
+  "listings"?: number;
+  "p25"?: number;
+  "p50"?: number;
+  "p75"?: number;
+}
+
 export interface ModelEsAppRecord {
   "android_max_installs"?: number;
   "android_package"?: string;
@@ -12869,6 +12972,52 @@ export type DatasetsListResponse = CrawloraResponse<ModelDatasetsListResponseDoc
 export interface DatasetsListParams {
 }
 
+export type DatasetsAirbnbMarketsFacetsResponse = CrawloraResponse<ModelDatasetsAirbnbMarketsFacetResponseDoc>;
+export interface DatasetsAirbnbMarketsFacetsParams {
+  "facet": string;
+  "group_by"?: string;
+  "country"?: string;
+  "market"?: string;
+  "superhost"?: boolean;
+  "min_rating"?: number;
+  "min_review_count"?: number;
+  "active_since"?: string;
+  "min_listings"?: number;
+}
+
+export type DatasetsAirbnbMarketsItemResponse = CrawloraResponse<ModelDatasetsAirbnbMarketResponseDoc>;
+export interface DatasetsAirbnbMarketsItemParams {
+  "country": string;
+}
+
+export type DatasetsAirbnbMarketsNearbyResponse = CrawloraResponse<ModelDatasetsAirbnbMarketsNearbyResponseDoc>;
+export interface DatasetsAirbnbMarketsNearbyParams {
+  "lat": number;
+  "lon": number;
+  "radius_m": number;
+  "precision"?: number;
+  "min_listings"?: number;
+  "country"?: string;
+  "superhost"?: boolean;
+  "min_rating"?: number;
+  "active_since"?: string;
+}
+
+export type DatasetsAirbnbMarketsSearchResponse = CrawloraResponse<ModelDatasetsAirbnbMarketsSearchResponseDoc>;
+export interface DatasetsAirbnbMarketsSearchParams {
+  "group_by"?: string;
+  "country"?: string;
+  "market"?: string;
+  "superhost"?: boolean;
+  "min_rating"?: number;
+  "min_review_count"?: number;
+  "active_since"?: string;
+  "min_listings"?: number;
+  "sort"?: string;
+  "page"?: number;
+  "page_size"?: number;
+}
+
 export type DatasetsAppsChartsSearchResponse = CrawloraResponse<ModelDatasetsChartsSearchResponseDoc>;
 export interface DatasetsAppsChartsSearchParams {
   "q"?: string;
@@ -16133,6 +16282,10 @@ export interface WebService {
 
 export interface DatasetsService {
   list<T = DatasetsListResponse>(params?: DatasetsListParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
+  airbnbMarketsFacets<T = DatasetsAirbnbMarketsFacetsResponse>(params: DatasetsAirbnbMarketsFacetsParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
+  airbnbMarketsItem<T = DatasetsAirbnbMarketsItemResponse>(params: DatasetsAirbnbMarketsItemParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
+  airbnbMarketsNearby<T = DatasetsAirbnbMarketsNearbyResponse>(params: DatasetsAirbnbMarketsNearbyParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
+  airbnbMarketsSearch<T = DatasetsAirbnbMarketsSearchResponse>(params?: DatasetsAirbnbMarketsSearchParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
   appsChartsSearch<T = DatasetsAppsChartsSearchResponse>(params?: DatasetsAppsChartsSearchParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
   appsReviewsSearch<T = DatasetsAppsReviewsSearchResponse>(params?: DatasetsAppsReviewsSearchParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
   appsSearch<T = DatasetsAppsSearchResponse>(params?: DatasetsAppsSearchParams, options?: import('./index.js').CrawloraRequestOptions): Promise<T>;
@@ -16802,6 +16955,10 @@ export interface OperationParamsMap {
   "coingecko-trending": CoinGeckoTrendingParams;
   "contact": WebContactParams;
   "datasets-list": DatasetsListParams;
+  "datasets-airbnb-markets-facets": DatasetsAirbnbMarketsFacetsParams;
+  "datasets-airbnb-markets-item": DatasetsAirbnbMarketsItemParams;
+  "datasets-airbnb-markets-nearby": DatasetsAirbnbMarketsNearbyParams;
+  "datasets-airbnb-markets-search": DatasetsAirbnbMarketsSearchParams;
   "datasets-apps-charts-search": DatasetsAppsChartsSearchParams;
   "datasets-apps-reviews-search": DatasetsAppsReviewsSearchParams;
   "datasets-apps-search": DatasetsAppsSearchParams;
@@ -17330,6 +17487,10 @@ export interface OperationResponseMap {
   "coingecko-trending": CoinGeckoTrendingResponse;
   "contact": WebContactResponse;
   "datasets-list": DatasetsListResponse;
+  "datasets-airbnb-markets-facets": DatasetsAirbnbMarketsFacetsResponse;
+  "datasets-airbnb-markets-item": DatasetsAirbnbMarketsItemResponse;
+  "datasets-airbnb-markets-nearby": DatasetsAirbnbMarketsNearbyResponse;
+  "datasets-airbnb-markets-search": DatasetsAirbnbMarketsSearchResponse;
   "datasets-apps-charts-search": DatasetsAppsChartsSearchResponse;
   "datasets-apps-reviews-search": DatasetsAppsReviewsSearchResponse;
   "datasets-apps-search": DatasetsAppsSearchResponse;
@@ -17858,6 +18019,10 @@ export interface OperationRequiredParamsMap {
   "coingecko-trending": false;
   "contact": true;
   "datasets-list": false;
+  "datasets-airbnb-markets-facets": true;
+  "datasets-airbnb-markets-item": true;
+  "datasets-airbnb-markets-nearby": true;
+  "datasets-airbnb-markets-search": false;
   "datasets-apps-charts-search": false;
   "datasets-apps-reviews-search": false;
   "datasets-apps-search": false;
@@ -18393,6 +18558,10 @@ export type OperationIdLiteral =
   | "coingecko-trending"
   | "contact"
   | "datasets-list"
+  | "datasets-airbnb-markets-facets"
+  | "datasets-airbnb-markets-item"
+  | "datasets-airbnb-markets-nearby"
+  | "datasets-airbnb-markets-search"
   | "datasets-apps-charts-search"
   | "datasets-apps-reviews-search"
   | "datasets-apps-search"
@@ -18918,6 +19087,10 @@ export declare const OperationIds: Readonly<{
   CoinGeckoTokenUnlocks: "coingecko-token-unlocks";
   CoinGeckoTreasuries: "coingecko-treasuries";
   CoinGeckoTrending: "coingecko-trending";
+  DatasetsAirbnbMarketsFacets: "datasets-airbnb-markets-facets";
+  DatasetsAirbnbMarketsItem: "datasets-airbnb-markets-item";
+  DatasetsAirbnbMarketsNearby: "datasets-airbnb-markets-nearby";
+  DatasetsAirbnbMarketsSearch: "datasets-airbnb-markets-search";
   DatasetsAppsChartsSearch: "datasets-apps-charts-search";
   DatasetsAppsReviewsSearch: "datasets-apps-reviews-search";
   DatasetsAppsSearch: "datasets-apps-search";