Search Things
Searches things in Bubble.
This node is also exposed as an AI Agent tool.
This node has 1 input port and 1 output port.
Common Properties
Every node shares these.
- Name — the node's display name on the canvas.
- Color — the node's colour on the canvas.
- Delay Before (sec) — wait this long before the node runs.
- Delay After (sec) — wait this long after the node runs.
- Continue On Error — carry on instead of failing the flow. Defaults to false.
info
When Continue On Error is true the error is not raised at all, so a Catch node will not see it either.
Inputs
| Property | Field | Description |
|---|---|---|
| Client ID | inClientID | Client ID from Connect node (optional if Credentials are set) |
| Constraints | inConstraints | Optional JSON array of constraints [{key，constraint_type，value}] |
| Data Type | inDataType | Name of the Bubble Data Type |
Outputs
| Property | Field | Description |
|---|---|---|
| Count | outCount | Number of Things returned in this response |
| Remaining | outRemaining | Number of Things left after this page (only meaningful when Return All is No) |
| Results | outResults | Array of matching Things |
Options
| Property | Field | Description |
|---|---|---|
| Credentials | optCredentials | Bubble API Token (optional when Client ID is provided) |
| Cursor | optCursor | Starting offset (0-based) |
| Limit | optLimit | Maximum number of results per page (1-100) |
| Return All | optReturnAll | If Yes，automatically paginates through all results One of: false, true. |
| Sort Field | optSortField | Field name to sort on (use _random_sorting for random order) |
| Sort Order | optDescending | Sort direction One of: false, true. |
| Timeout (seconds) | optTimeout | Maximum time in seconds to wait for the API response |
Requirements
- A Client ID from this package's Connect node, unless you set credentials directly on this node.
- Bubble API Token — API token and app configuration for Bubble.io
value— API Token (password, required). API token from Bubble Settings > APIapp_name— App Name (text, optional). Bubble app name (the subdomain of myapp.bubbleapps.io). Leave empty if using Base URL.environment— Environment (text, optional). Use 'development' for /version-test or 'live' for productionbase_url— Custom Base URL (text, optional). Optional. Overrides App Name + Environment. Useful for custom domains or local testing.
Store these in a Vault and reference the vault item from the node, rather than typing the secret into the property.
Related nodes
Create Thing · Get Thing · Update Thing · Delete Thing · Bulk Create Things
Elsewhere in the package: Connect · Disconnect · Run Workflow · Toolkit
See also
- Bubble — every node in this package
- Message object — how properties read values from
msg - Handling failure — Continue On Error, Catch and retries