# Workflow Application: SEMANTICSEARCH usage

**URL:** <https://discuss.workflowgen.com/t/workflow-application-semanticsearch-usage/2311>\
**Category:** Workflow Applications\
**Created:** [August 13, 2025, 7:20pm UTC](https://discuss.workflowgen.com/t/workflow-application-semanticsearch-usage/2311 "2025-08-13T19:20:48Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![wfg-admin](https://yyz2.discourse-cdn.com/flex030/user_avatar/discuss.workflowgen.com/wfg-admin/32/714_2.png) [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\
**Post date:** [August 13, 2025, 7:20pm UTC](https://discuss.workflowgen.com/t/workflow-application-semanticsearch-usage/2311/1 "2025-08-13T19:20:48Z")

</div>

The **SEMANTICSEARCH** workflow application performs a hybrid full-text and semantic search on requests, with customizable filters and scoring. It returns structured JSON results for use in process logic.

> **Note:** SEMANTICSEARCH is available as of WorkflowGen version 10.0.1 (v10 Preview 2).

## Required parameters

| Parameter | Type | Direction | Description |
| --- | --- | --- | --- |
| `QUERY` | TEXT | IN | The main search query (full-text and similarity) |
| `QUERY_DATA_<NAME>` | TEXT | IN | Query for a specific data field (e.g. `QUERY_DATA_TITLE`) |
| `RESULT` | TEXT | OUT | JSON string containing the search results |

> **Note:** At least one of `QUERY` or `QUERY_DATA_<NAME>` must be provided.

## Optional parameters

| Parameter | Type | Direction | Description |
| --- | --- | --- | --- |
| `REQUEST_ID` | NUMERIC | IN | The request number to filter on |
| `REQUEST_STATE` | TEXT | IN | Request state: `OPEN` or `CLOSED` |
| `REQUEST_SUBSTATE` | TEXT | IN | Substate: for `OPEN`, use `NOT_RUNNING_NOT_STARTED` or `RUNNING`; for `CLOSED`, use `COMPLETED` or `ABORTED` |
| `REQUEST_CREATED_AT_FROM` | DATETIME | IN | Filter: request created at (from) |
| `REQUEST_CREATED_AT_TO` | DATETIME | IN | Filter: request created at (to) |
| `REQUEST_CLOSED_AT_FROM` | DATETIME | IN | Filter: request closed at (from) |
| `REQUEST_CLOSED_AT_TO` | DATETIME | IN | Filter: request closed at (to) |
| `REQUESTER_USERNAME` | TEXT | IN | Requester’s username |
| `PROCESS_NAME` | TEXT | IN | Process name |
| `PROCESS_VERSION` | NUMERIC | IN | Process version |
| `QUERY_SCORE` | NUMERIC | IN | Score threshold for the main query (default: `0.5`) |
| `QUERY_SCORE_DATA_` | NUMERIC | IN | Score threshold for the specific data field query |
| `SELECT_DATA_LIST` | TEXT | IN | Comma- or semicolon-separated list of data fields to include in the search result |

---

<div class="post-metadata">

**Author:** ![pnicoll](https://yyz2.discourse-cdn.com/flex030/user_avatar/discuss.workflowgen.com/pnicoll/32/454_2.png) [@pnicoll](https://discuss.workflowgen.com/u/pnicoll)\
**Post date:** [June 15, 2026, 7:43pm UTC](https://discuss.workflowgen.com/t/workflow-application-semanticsearch-usage/2311/2 "2026-06-15T19:43:45Z")

</div>