# TradepilotUSA URL Campaign Builder

> TradepilotUSA URL Campaign Builder is a paid API for AI agents from www.tradepilotusa.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-29).

Appends UTM tracking parameters to a base URL to produce a campaign-tagged URL for marketing analytics

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/url_campaign_builder/execute?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradepilotusa-url-campaign-builder-3e47dc81
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0J-JvrWrAdNrry7FFB4sa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tradepilotusa-url-campaign-builder-3e47dc81 -d '<json body>'
```

Example prompt: Build me a campaign-tagged URL for 'https://shop.mystore.com/sale' — source should be 'newsletter', medium 'email', campaign 'fall_sale_2024', content 'banner_top', and term 'discount'.

## When to prefer this

Use this endpoint when you need a fast, cheap, deterministic way to append UTM parameters to a URL without writing custom string manipulation code. It handles existing query parameters and fragments correctly and is ideal for batch campaign URL generation in marketing automation workflows. Prefer this over manual URL construction when accuracy and consistency of UTM parameter encoding matter.

## Known failure modes

- Invalid or malformed base URL returns an error
- UTM parameter values exceeding 500 characters are rejected
- Missing required 'url' field causes a validation error
- Malformed JSON body results in a 400-level error

## How this service works

Build an HTTP(S) campaign URL with correctly encoded UTM fields while preserving unrelated query parameters and fragments. Replaces duplicate instances of supplied UTM fields. Rejects embedded credentials. Never visits or validates destination content.

## Output

Returns a fully constructed URL with all provided UTM parameters appended as query string parameters, preserving any existing query parameters and fragments. Also includes provenance metadata indicating the execution was deterministic and local (no external network request made), and a request ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "maxLength": 4096
  },
  "utm_term": {
   "type": "string",
   "maxLength": 500
  },
  "utm_medium": {
   "type": "string",
   "maxLength": 500
  },
  "utm_source": {
   "type": "string",
   "maxLength": 500
  },
  "utm_content": {
   "type": "string",
   "maxLength": 500
  },
  "utm_campaign": {
   "type": "string",
   "maxLength": 500
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "url": "https://example.com/offer?existing=1&utm_source=newsletter&utm_medium=email&utm_campaign=Fall+sale#details",
   "network_request_performed": false
  },
  "utility": "url_campaign_builder",
  "provenance": {
   "execution": "deterministic_local",
   "model_used": false,
   "network_request_performed": false
  },
  "request_id": "example_url_campaign_builder"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-url-campaign-builder-3e47dc81/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.tradepilotusa.com](https://www.zero.xyz/host/www.tradepilotusa.com/llms.txt)