---
title: "Facet stored Google Maps businesses"
method: GET
path: "/datasets/google-map-businesses/facets"
tags: ["Datasets"]
---

# Facet stored Google Maps businesses

`GET /datasets/google-map-businesses/facets`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/google-map-businesses/facets`
- Auth: API key in header `x-api-key`

Returns terms aggregation counts for Google Maps businesses. Facet enum: `category`, `country`, `state`, `state_code`, `county`, `county_code`, `city`, `town`, `website_status`. Category facet values are exact locale-specific Google Maps labels and can be localized, non-ASCII, or contain punctuation; pass a returned value unchanged to the category filter. `state` and `county` keep each country's own administrative vocabulary (e.g. `Provincia de Madrid`, `Département du Nord`); `state_code` and `county_code` are the matching ISO 3166-2 codes (e.g. `ES-MD`, `FR-59`) and are the stable cross-country grouping key. Rows not yet resolved carry no code and are absent from the code facets.

## Query parameters

- `facet` 'category' | 'country' | 'state' | 'state_code' | 'county' | 'county_code' | 'city' | 'town' | 'website_status', required
- `q` string
- `category` string
- `country` string
- `state` string
- `county` string
- `state_code` string
- `county_code` string
- `city` string
- `town` string
- `min_rating` number
- `min_review_count` integer
- `has_website` boolean
- `has_phone` boolean
- `has_geo` boolean
- `permanently_closed` boolean
- `lat` number
- `lon` number
- `radius_m` integer
- `sort` 'relevance' | 'updated_at_desc' | 'rating_desc' | 'review_count_desc' | 'distance_asc'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsGoogleMapBusinessesFacetResponseDoc
  - `code` integer
  - `data` DatasetsGoogleBusinessFacetResponse
    - `dataset` string: Identifier of the dataset queried (`google-map-businesses`).
    - `facet` string: Facet that was aggregated.
    - `items` EsGoogleBusinessDatasetFacetItem[]: Facet values with the number of matching records for each.
      - `count` integer: Number of businesses with this value.
      - `value` string: Facet value being counted.
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)