---
title: "Valid AI-search filters for your region"
method: GET
path: "/ai-search/filters"
tags: ["AI Search"]
---

# Valid AI-search filters for your region

`GET /ai-search/filters`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/ai-search/filters`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

The filter vocabulary the `/ai-search/*` endpoints accept for your shop's region — call this before building a `filters` payload rather than guessing at keys or enum spellings.

`filters` maps each categorical field (product categories, follower age and gender, content language, production quality, face visibility, `hasEmail`, …) to its allowed `{label, value}` options. `creatorLevel` options additionally carry `min` and `max` — the half-open `[min, max)` GMV band that level stands for, so you can map a `gmv` range onto levels without hardcoding our thresholds. A side is OMITTED where the band is unbounded (the lowest level has no `min`, the highest no `max`), and the `All` option carries neither. No other filter's options carry them at all. When mapping, mind that the `gmv` filter's own `max` is INCLUSIVE while a band's is exclusive, so a range ending exactly on a threshold also overlaps the level above it.

`sliders` gives the numeric ranges — `min`, `max` and `step` for `averageViews`, `engagementRate`, `gmv`, `unitsSold`, `postRate` and `followers`.

The response is region-stripped: a filter whose backing column has effectively no data in your region is omitted entirely, because applying it would return zero creators regardless of the range. `postRate` is absent for most non-US/UK regions and the community hashtag filter is absent where the hashtag pipeline hasn't tagged enough creators — treat anything missing here as unsupported for your shop.

Region comes from the shop, so this needs a single `x-shop-id`.

## Response `200`

Successful Response

- FiltersResponse
  - `region` 'US' | 'UK' | 'IT' | 'ES' | 'DE' | 'FR' | 'IE' | 'MX' | 'BR' | 'JP' | 'NL' | 'AT' | 'BE' | 'CZ' | 'GR' | 'HU' | 'PL' | 'PT', required
  - `filters` object, required
  - `sliders` object, required

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-10-10** `2840b044a7da`: 2 info
  - added the optional property `filters/additionalProperties/items/max` to the response with the `200` status
  - added the optional property `filters/additionalProperties/items/min` to the response with the `200` status

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/ai-search/filters/get.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)