Feishu Table

Manage Feishu Bitable (Multidimensional Table) records

Search Records

AI-generated

Summary

Search records in a specified Feishu Bitable table using optional filtering criteria and pagination controls.

Inputs

  • Bitable URL (required) — The full URL of the Feishu Bitable, which includes the app token and table ID necessary to identify the data source.
  • View ID — An optional View ID to filter records according to a specific view preset in the Bitable.
  • Filter Formula — A formula string to filter records based on field values (e.g., CurrentValue.[Field] = "Value").
  • Return All (required) — Boolean flag to indicate whether to return all matching records or limit the result set.
  • Limit — The maximum number of records to return when 'Return All' is false.

Output shape

A list of records matching the search criteria, each as an individual item containing record details.

The operation paginates through results internally when 'Return All' is true, fetching up to 500 records per request until all matches are retrieved or limit is reached. If 'Return All' is false, the result set is truncated to the specified limit. Each output item contains a JSON object representing a single record. Errors during the search will throw exceptions unless 'Continue On Fail' is enabled, in which case error details appear as output items.

Links

Discussion