---
title: "Get total count of search"
method: GET
path: "/table/{tableId}/aggregation/search-count"
tags: ["aggregation"]
---

# Get total count of search

`GET /table/{tableId}/aggregation/search-count`

Returns the total count of records matching the specified search criteria and filters

## Path parameters

- `tableId` string, required

## Query parameters

- `filter` string — A filter object for complex query conditions based on fields, operators, and values. Use our visual query builder at https://app.teable.ai/developer/tool/query-builder to build filters.
- `viewId` string — Set the view you want to fetch, default is first view. result will filter and sort by view options.
- `search` union — Search for records that match the specified field and value
  - string[]
  - string[]
  - union[]
    - union
      - string
      - string
      - boolean
- `ignoreViewQuery` union — When a viewId is specified, configure this to true will ignore the view's filter, sort, etc
  - string
  - boolean

## Response `200`

Search count with query

- object
  - `count` number, required

---

[API](https://skmtc.net/teable/apis/teable-app.md) · [All operations](https://skmtc.net/teable/apis/teable-app/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/teable/teable-app/versions/7515f3b33d79/schema)