# TradepilotUSA Blog Brief Generator

> TradepilotUSA Blog Brief Generator 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).

Generates a structured writing brief for blog or marketing content based on a topic brief, target audience, and optional source text.

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/blog_brief/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-blog-brief-generator-f5a01e76
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nyDUfdZ75OXV7aSfAMELO

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-blog-brief-generator-f5a01e76 -d '<json body>'
```

Example prompt: Can you generate a blog writing brief for my door installation company in Dallas? The brief should target homeowners considering a consultation before getting a quote, and here's a paragraph about our services you can use as source material: 'Example Door Company installs residential entry doors across the Dallas metro area, offering free in-home consultations before finalizing any quote.'

## When to prefer this

Choose this endpoint when you need a structured, actionable writing brief rather than a finished blog post — ideal for briefing human writers or content contractors, or for generating an outline to iterate on. Best suited for service-area businesses (trade contractors, local services) targeting specific geographic audiences. Prefer this over full content-generation endpoints when you want a planning artifact with explicit assumptions and evidence gaps surfaced for review.

## Known failure modes

- Brief text too short (below 10 characters) returns validation error
- Brief or source text exceeds character limits (12,000 / 32,000) returns 400
- Vague or underspecified brief may produce generic outlines with many evidence gaps
- Missing audience may result in a brief with assumed or placeholder audience segment
- Payment failure via x402 protocol returns 402 before execution

## How this service works

Produce a writing brief with audience, thesis, outline, evidence needed, and acceptance criteria. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a structured blog writing brief including a summary, a detailed artifact with sections like audience overview, thesis, and content outline, a list of assumptions made, identified evidence gaps, a flag indicating whether human review is needed, and a request ID for tracking.

## 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
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "task": "blog_brief",
  "summary": "A writing brief for content encouraging Dallas residential customers to request consultations before final quotes, targeting the business operations manager of Example Door Company. The brief includes",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n# Writing Brief for Example Door Company Consultation Request Content\n\n## Audience\n- Business operations manager at Example Door Company\n\n## Thesis\nEncourage potential residential customers in Dallas to request a consultation before receiving a final quote, using clear and practical language.\n\n## Outline\n1. Introduction\n   - Briefly introduce Example Door Company as a residential entry door installer in Dallas.\n2. Consultation Process\n   - Explain the importance of requesting a consultation prio",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:38:34.311Z",
   "external_research_performed": false
  },
  "request_id": "example_blog_brief",
  "assumptions": [
   "The content is intended for potential residential customers in Dallas.",
   "Consultations are a prerequisite to final quotes as per company policy."
  ],
  "evidence_gaps": [
   "Details on how customers can request consultations (e.g., online, phone).",
   "Information on consultation format (in-person, virtual, phone)."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-blog-brief-generator-f5a01e76/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)