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

# AI Keyword Data Search

> Configure a workflow step that returns AI search volume and 12-month trend data for keywords

Use **AI Keyword Data Search** when you want a workflow step to look up AI search volume for one or more keywords, including a 12-month trend, then pass that data into later workflow steps.

## Configuration

| Option              | Required | Description                                                                                                                                                          |
| ------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                | No       | Label for the step in the workflow canvas.                                                                                                                           |
| Keywords            | Yes      | One keyword per line, or comma-separated. Up to 1000 keywords, 250 characters each. This field supports workflow variables through **Insert Variable**.              |
| Language            | No       | Language value in **Language**. You can choose from the list or enable **Custom Value**.                                                                             |
| Location            | No       | Numeric location code in **Location** (for example `2840`). Choose from the list, or enable **Custom Value** with a numeric code or a variable that resolves to one. |
| When the step fails | No       | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails.                                                                      |

Add this step from the **Research** group in **Search steps...**.

The keywords field supports **Insert Variable**. The **Language** and **Location** controls can use the built-in lists or switch to **Custom Value**.

## Output

Click **Run** in the step header to test the step. Fetch Hive shows the keyword volume results in **Output** after the run completes.

Use the variable picker in a later step to insert the exact output path available for that run. The base reference is:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

The output includes `items_count` and an `items` array. Each item includes the keyword, current AI search volume, and a 12-month `ai_monthly_searches` trend. To use the first keyword's volume:

```text theme={null}
{{step_2.output.items[0].ai_search_volume}}
```

Use the variable picker after a test run to inspect nested fields such as `ai_monthly_searches`.

## Example

Add **AI Keyword Data Search** from the **Research** group in **Search steps...**.

Set **Name** to something like `Keyword volume`.

Enter one or more keywords in **Keywords**, one per line or comma-separated. If the list should reuse data from earlier workflow steps, click **Insert Variable** and add that reference.

Choose **Language** and **Location**, then click **Run** and review the returned volumes in **Output** before using them in a later step.

## Notes

* You can send up to 1000 keywords in a single run. Each keyword can be up to 250 characters.
* This step returns the full result set for the submitted keywords. There is no pagination.
* Hosted runs convert the recorded service cost plus a 6% service fee into task credits. See [Task costs](../../../resources/task-costs).

See also: [Creating and Editing](../../creating-and-editing), [Testing and Iteration](../../testing-and-iteration), and [Error Handling](../../error-handling)