---
title: "search_campaigns_by_utm_value. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/search_campaigns_by_utm_value
description: "Find campaigns whose UTM tracking parameters CONTAIN a given value - the only correct way to answer \"which campaigns use / still say X in their UTMs\". Read tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# search_campaigns_by_utm_value

Find campaigns whose UTM tracking parameters CONTAIN a given value - the only correct way to answer "which campaigns use / still say X in their UTMs".

Read [campaigns](https://metadata.io/developers/tools/#cat-campaigns)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `utm_value` | string | required | Case-insensitive substring to look for in the campaigns' effective UTM values (e.g. 'UPDATE ME'). Minimum 3 characters. |
| `page` | integer |   | 0-based page index. Default: 0 |
| `size` | integer |   | Results per page. Default: 25 |
| `sort_by` | string |   | Field to sort by. Default: createdDateone of: `createdDate`, `startDate`, `endDate`, `name`, `budget`, `spent`, `leads`, `cpl`, `cpc`, `ctr`, `impressions`, `clicks` |
| `sort_order` | string |   | Sort order. Default: descone of: `asc`, `desc` |
| `status` | string |   | Campaign-level status filter. Comma-separated subset of Draft, Launched, Finished. Omit to include all three. |
| `experiment_statuses` | string |   | Experiment-level status filter. Comma-separated subset of Active, WithoutSpend, Paused, Completed, Failed. Omit to include all five. |
| `visibility` | string |   | Optional: filter by campaign visibility. Omit to include all.one of: `VISIBLE`, `ARCHIVED` |
| `name` | string |   | Optional: additional server-side campaign name substring filter. |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

## Related

Other campaigns tools:

- [add_and_edit_campaign_elements](https://metadata.io/developers/tools/add_and_edit_campaign_elements) Destructive
- [add_and_edit_native_campaign_elements](https://metadata.io/developers/tools/add_and_edit_native_campaign_elements) Destructive
- [archive_campaigns](https://metadata.io/developers/tools/archive_campaigns) Destructive
- [check_campaign_launch_readiness](https://metadata.io/developers/tools/check_campaign_launch_readiness) Read
- [connect_channel](https://metadata.io/developers/tools/connect_channel) Writes
- [create_budget_group](https://metadata.io/developers/tools/create_budget_group) Destructive
- [create_campaign](https://metadata.io/developers/tools/create_campaign) Writes
- [create_native_structure_campaign](https://metadata.io/developers/tools/create_native_structure_campaign) Writes

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)