> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tappify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# useTapFilters

> Returns the date range, platform and country the owner's filter bar is set to.

```ts theme={null}
function useTapFilters(): TapFilters;
```

Returns the date range, platform and country the owner's filter bar is set to.

## Returns

[`TapFilters`](/extensions/reference/frontend-api/Interface.TapFilters)

## Remarks

Re-renders on every filter change, which is how a surface follows the owner's
picker. Pass `range` into a `series`, `reviews`, `crashes` or `revenue` query
yourself; the host adds only the country to a data read, while a procedure call
carries all three. Throws `TAP_OUTSIDE_HOST` outside a mount.

## Example

```tsx theme={null}
import { useTapFilters, useTapQuery } from '@tappify/extension-sdk';

function Downloads() {
  const filters = useTapFilters();
  const downloads = useTapQuery({
    kind: 'series',
    metric: 'downloads',
    range: filters.range,
  });
  return <span>{downloads.data?.points.length ?? 0} days</span>;
}
```