Endpoint Playground

Try the Facet the Airbnb hosts dataset API

Returns distribution counts over the Airbnb hosts dataset (dataset id enum value `airbnb-hosts`), honoring the same filters as search. Facet enum: `superhost`, `identity_verified`, `listing_count_band`, `hosting_years_band`, `interest`, `verification`, `location`. Dataset Playground requests query indexed data and do not apply proxy routing.

What a live request returned

6 Nov 2026: 2 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/airbnb-hosts/facets?facet=superhost
Fields with a value in every checked item: value, count

Sample value profiles: count: 322,674 to 470,007, median 322,674.

Request: GET /datasets/airbnb-hosts/facets
Cost: 1 credit/request
Auth: apiKey

Facet the Airbnb hosts dataset API documentation Datasets platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/datasets/airbnb-hosts/facets?facet=superhost' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	superhost	Facet enum: superhost, identity_verified, listing_count_band, hosting_years_band, interest, verification, location
q	string	No		Full-text query over host name and bio, max 256 characters
location	string	No		Free-text match over the profile location, max 128 characters
interest	string	No		Exact interest as returned by the interest facet, max 128 characters
verification	string	No		Exact verification as returned by the verification facet, max 128 characters
is_superhost	boolean	No		true keeps only Superhosts, false keeps only hosts without the badge
is_home_host	boolean	No		Filter on the home-host flag
identity_verified	boolean	No		true keeps only hosts whose identity is verified
min_listings	integer	No		Minimum number of listings the host manages, 0 or greater
max_listings	integer	No		Maximum number of listings the host manages, 0 or greater
min_reviews	integer	No		Minimum total guest reviews received, 0 or greater
min_hosting_years	integer	No		Minimum years of hosting, 0 or greater

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "airbnb-hosts",
    "facet": "listing_count_band",
    "items": [
      {
        "value": "1",
        "count": 18234
      },
      {
        "value": "2-4",
        "count": 4150
      },
      {
        "value": "5-9",
        "count": 830
      },
      {
        "value": "10-49",
        "count": 210
      },
      {
        "value": "50+",
        "count": 12
      }
    ]
  }
}

More Datasets endpoints

List stored scraped datasets Get an Airbnb host from the dataset Search the Airbnb hosts dataset Facet the Airbnb markets dataset Get an Airbnb market from the dataset Airbnb market density near a coordinate Search the Airbnb markets dataset Discover Apple Books dataset values Get an Apple Books record Search Apple Books records Facet stored Apple Maps places Get a stored Apple Maps place All 168 Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.airbnbHostsFacetResponseDocDatasets

GET /datasets/airbnb-hosts/facets

Facet the Airbnb hosts dataset

Response behavior

- Each item is a `{ value, count }` bucket. - For `facet=superhost` and `facet=identity_verified`, `value` is `true` or `false`. - For `facet=listing_count_band`, `value` is one of `0`, `1`, `2-4`, `5-9`, `10-49`, `50+`. - For `facet=hosting_years_band`, `value` is one of `0` (under a year or not shown), `1-2`, `3-5`, `6-9`, `10+`. - For `facet=interest` and `facet=verification`, `value` is the interest or verification text exactly as stored, and can be passed back to the matching search filter. - For `facet=location`, `value` is the location text exactly as hosts wrote it, so near-duplicates such as `Lisbon, Portugal` and `Lisboa, Portugal` appear as separate buckets. Use the `location` search filter to match by word instead. - Band buckets with no hosts are omitted; the other facets return up to `50` values, most common first. - Invalid enum values return the standard invalid params envelope. - Returns an empty `items` array (not an error) when nothing matches or the dataset has no data yet. - Does not trigger live scraping.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Facet enum: superhost, identity_verified, listing_count_band, hosting_years_band, interest, verification, location · allowed: superhost, identity_verified, listing_count_band, hosting_years_band, interest, verification, location

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "airbnb-hosts",
    "facet": "listing_count_band",
    "items": [
      {
        "value": "1",
        "count": 18234
      },
      {
        "value": "2-4",
        "count": 4150
      },
      {
        "value": "5-9",
        "count": 830
      },
      {
        "value": "10-49",
        "count": 210
      },
      {
        "value": "50+",
        "count": 12
      }
    ]
  }
}

Endpoint Playground

Try the Facet the Airbnb hosts dataset API

What a live request returned

6 Nov 2026: 2 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/airbnb-hosts/facets?facet=superhost
Fields with a value in every checked item: value, count

Sample value profiles: count: 322,674 to 470,007, median 322,674.

Request: GET /datasets/airbnb-hosts/facets
Cost: 1 credit/request
Auth: apiKey

Facet the Airbnb hosts dataset API documentation Datasets platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/datasets/airbnb-hosts/facets?facet=superhost' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	superhost	Facet enum: superhost, identity_verified, listing_count_band, hosting_years_band, interest, verification, location
q	string	No		Full-text query over host name and bio, max 256 characters
location	string	No		Free-text match over the profile location, max 128 characters
interest	string	No		Exact interest as returned by the interest facet, max 128 characters
verification	string	No		Exact verification as returned by the verification facet, max 128 characters
is_superhost	boolean	No		true keeps only Superhosts, false keeps only hosts without the badge
is_home_host	boolean	No		Filter on the home-host flag
identity_verified	boolean	No		true keeps only hosts whose identity is verified
min_listings	integer	No		Minimum number of listings the host manages, 0 or greater
max_listings	integer	No		Maximum number of listings the host manages, 0 or greater
min_reviews	integer	No		Minimum total guest reviews received, 0 or greater
min_hosting_years	integer	No		Minimum years of hosting, 0 or greater

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "airbnb-hosts",
    "facet": "listing_count_band",
    "items": [
      {
        "value": "1",
        "count": 18234
      },
      {
        "value": "2-4",
        "count": 4150
      },
      {
        "value": "5-9",
        "count": 830
      },
      {
        "value": "10-49",
        "count": 210
      },
      {
        "value": "50+",
        "count": 12
      }
    ]
  }
}

More Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.airbnbHostsFacetResponseDocDatasets

GET /datasets/airbnb-hosts/facets

Facet the Airbnb hosts dataset

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "airbnb-hosts",
    "facet": "listing_count_band",
    "items": [
      {
        "value": "1",
        "count": 18234
      },
      {
        "value": "2-4",
        "count": 4150
      },
      {
        "value": "5-9",
        "count": 830
      },
      {
        "value": "10-49",
        "count": 210
      },
      {
        "value": "50+",
        "count": 12
      }
    ]
  }
}