---
title: "US places Category Breakdown API"
slug: category-breakdown-in-bbox
url: https://apyhub.com/dosvak/service/category-breakdown-in-bbox
provider: Dosvak LLC
categories: [Geolocation]
tags: [geospatial, location-analytics, bbox, map-data, category-counts]
auth: api_key
---

# US places Category Breakdown API 

Count place categories inside a bounding box defined by min and max latitude and longitude. Useful for map filtering and area-level analytics.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/dosvak/category-breakdown-in-bbox` | What it does Returns a category breakdown for places within a bounding box defined by latitude and… | 100 |

## Examples

### Category breakdown in bbox

#### Quickstart

Call this endpoint with the four required bounding-box coordinates as query parameters to get a category breakdown for that area.

```bash
curl -X GET "https://api.eu.apyhub.com/dosvak/category-breakdown-in-bbox?min_lat=34.04&min_lon=-118.26&max_lat=34.07&max_lon=-118.22" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object. The schema does not declare any fixed top-level fields, so the response shape may include additional properties.

```json
{
  "input": {
    "min_lat": 34.04,
    "min_lon": -118.26,
    "max_lat": 34.07,
    "max_lon": -118.22,
    "limit": 1
  },
  "count": 5,
  "results": [
    {
      "category": "footway",
      "feature_count": 5143
    }
  ]
}
```

## About

## What it does
Category Breakdown gives you a count of locations by category inside a geographic bounding box. Send `min_lat`, `min_lon`, `max_lat`, and `max_lon`, and optionally set `limit` to control how many categories are returned.

Use it when you need to understand what kinds of places exist in an area before rendering a map, filtering search results, or summarizing local inventory. The response is a JSON object, so you can work with the breakdown directly in your app without extra parsing steps.

Category Breakdown is a good fit for location analytics workflows where the same area needs to be inspected repeatedly at different zoom levels. For example, you can compare restaurant-heavy neighborhoods, measure the density of retail categories around a store site, or build a map legend from the most common place types in view.

The service accepts only bounding-box coordinates and a result limit. It returns a JSON object containing the category breakdown for places within the specified bounding box, along with related metadata.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/dosvak/service/category-breakdown-in-bbox