v1Resources/Locations/getSearch the general category taxonomy

Search the general category taxonomy

Searches the general business category taxonomy (mirrors Google's, thousands of entries) — global reference data, not scoped to your agency. The returned id is a Category id to set as a location's categoryId on create or update. For a specific publisher's own catalog, use GET /api/v1/locations/publisher-categories instead. Omit search entirely to list the full taxonomy, uncapped.

get/api/v1/locations/categories
locations:read
Query parameters
searchstringoptional
Category name substring to match. Omit to list the entire taxonomy, uncapped (limit is ignored in that case).
limitintegeroptional
Rows to return, 1–100. Defaults to 25.
Response
dataobjectoptional
categoriesarray of objectoptional
The matching general categories.
idstringoptional
The Category id — pass this as categoryId on create or update.
namestringoptional
The category's display name.
Errors
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/locations/categories
Your API key
search
limit
{
  "data": {
    "categories": [
      {
        "id": "cat_dentist",
        "name": "Dentist"
      },
      {
        "id": "cat_orthodontist",
        "name": "Orthodontist"
      }
    ]
  }
}