---
title: "Available search filter values"
method: GET
path: "/locations/search-filters"
tags: ["Locations"]
---

# Available search filter values

`GET /locations/search-filters`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/locations/search-filters`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/locations/search-filters/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the distinct values available for the standard location filters across the account's accessible locations: tags, folders, categories, additional categories, and Google Business Profile (GBP) categories (primary and additional). Use these values to populate the filter controls before calling Filter locations.

## Headers

- `Synup-Version` string, required
- `Authorization` string, required

## Response `200`

Successful response

- object
  - `data` object
    - `searchFilters` LocationSearchFilterType
      - `tags` string[]
      - `folders` string[]
      - `categories` string[]
      - `additionalCategories` string[]
      - `primaryGbpSiteCategories` SitePublisherCategoryV2[]
        - `name` string: Name of the category.
        - `value` integer: Internal numeric identifier of the category.
        - `id` string: GBP site category identifier.
      - `additionalGbpSiteCategories` SitePublisherCategoryV2[]
        - `name` string: Name of the category.
        - `value` integer: Internal numeric identifier of the category.
        - `id` string: GBP site category identifier.

## Other responses

- `401`: Unauthorized - Invalid or missing API key

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)