apyhub
Back
▣ GEOLOCATION

US places Category Breakdown API

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.

GET
Category breakdown in bbox
https://api.eu.apyhub.com/dosvak/category-breakdown-in-bbox

QUICKSTART

GUIDE

Quickstart

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

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.

{
  "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
    }
  ]
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns a category breakdown for places within a bounding box defined by latitude and longitude limits. The request is made with query parameters only.

Query Parameter(s)

AttributeTypeMandatoryDescription
limitIntegerNoMaximum number of results to return.
Default: 20.
Minimum: 1.
Maximum: 200.
Example: 5
max_latNumberYesMaximum latitude of the bounding box.
Minimum: -90.
Maximum: 90.
Example: 34.07
max_lonNumberYesMaximum longitude of the bounding box.
Minimum: -180.
Maximum: 180.
Example: -118.22
min_latNumberYesMinimum latitude of the bounding box.
Minimum: -90.
Maximum: 90.
Example: 34.04
min_lonNumberYesMinimum longitude of the bounding box.
Minimum: -180.
Maximum: 180.
Example: -118.26

Response

Returns a JSON object containing the category breakdown for the specified bounding box, along with related metadata.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLFind Nearby Places in US by Category APIDosvak LLCCALLFind US Places in Bounding Box APIDosvak LLCCALLSearch US Places APIDosvak LLCCALLList Website Category APIDosvak LLC

From the blog

Reads that touch this API.

Top 5 Rank Tracking APIs to Build Your Own SEO Monitoring StackAug 24, 2026Automate Invoice Processing with SharpAPI’s Invoice Parsing API on ApyHubJul 9, 2026Ultimate Guide to Country Codes: What They Are and How to Use ThemJul 9, 2026How to Read and Understand API Documentation: A Simple Guide for DevelopersJul 9, 2026