# TradepilotUSA Metadata Rewrite

> TradepilotUSA Metadata Rewrite is a paid API for AI agents from www.tradepilotusa.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-02).

Rewrites and drafts page metadata (titles, descriptions, structured summaries) from a supplied content brief and source text for a target audience

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/metadata_rewrite/execute?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradepilotusa-metadata-rewrite-86143d0e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VMxadIpua-Z39xrUfpQE6

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-metadata-rewrite-86143d0e -d '<json body>'
```

Example prompt: Rewrite the page titles and meta descriptions for my door installation business — here's the brief: 'We offer residential and commercial door installation in Dallas, focusing on security and curb appeal' and here's my source text from the existing pages — target audience is homeowners in the Dallas area.

## When to prefer this

Choose this endpoint when you need to programmatically generate or rewrite SEO-oriented page titles and meta descriptions from structured briefs and source copy, especially for service or local businesses that need scalable metadata production. Prefer it over generic LLM calls when you want provenance tracking, assumption documentation, and evidence-gap flagging built into the response.

## Known failure modes

- Source text or brief below minimum length (minLength:20/10) returns validation error
- Brief or source text exceeds character limits (12000/32000) causing rejection
- Vague or contradictory brief results in low-confidence output with many evidence gaps and requires_human_review:true
- Missing audience field produces generic output not tailored to a specific reader
- Non-English or mixed-language input may yield inconsistent output quality

## How this service works

Generate page titles and descriptions from supplied page facts, including character counts and intent notes. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a JSON object containing a task label, a plain-language summary of what was drafted, an artifact with the full drafted page titles and descriptions, a provenance block (source, generation timestamp, whether external research was performed), a request ID, a list of assumptions made during generation, a list of evidence gaps identified in the supplied content, and a boolean flag indicating whether human review is recommended.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "brief": {
   "type": "string",
   "maxLength": 12000,
   "minLength": 10
  },
  "audience": {
   "type": "string",
   "maxLength": 500
  },
  "source_text": {
   "type": "string",
   "maxLength": 32000,
   "minLength": 20
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "task": "metadata_rewrite",
  "summary": "Drafted page titles and descriptions for two pages based on supplied fictional site facts and keywords, noting the absence of measurement preparation content and other service details. The draft is pr",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n### Page Titles and Descriptions Draft\n\n#### 1. Residential Entry Door Installation in Dallas\n- **Title:** Residential Entry Door Installation in Dallas | Expert Door Services (50 characters)\n- **Description:** Professional residential entry door installation services in Dallas. Enhance your home's security and curb appeal with our expert team. (139 characters)\n- **Intent:** Informational/Transactional – Users seeking door installation services in Dallas.\n\n#### 2. Door Consultations\n- **Title:**",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:41:05.463Z",
   "external_research_performed": false
  },
  "request_id": "example_metadata_rewrite",
  "assumptions": [
   "The supplied URLs correspond to two distinct pages: one for residential entry door installation and one for consultation",
   "Weekday consultations imply availability Monday through Friday without specific hours."
  ],
  "evidence_gaps": [
   "Detailed service descriptions, including pricing and unique selling points.",
   "Measurement preparation information for door installation."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-metadata-rewrite-86143d0e/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)