# TradepilotUSA Schema Suggestions Generator

> TradepilotUSA Schema Suggestions 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 JSON-LD structured data schema suggestions for a business service based on a brief, target audience, and source text

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/schema_suggestions/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-schema-suggestions-generator-931efb18
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g2nocdILXLccbgCTIpr-u

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-schema-suggestions-generator-931efb18 -d '<json body>'
```

Example prompt: Can you draft a JSON-LD schema for my Dallas-based residential door installation business called 'Premier Door Works'? The target audience is homeowners in the DFW area, and here's a description of my services: we install and replace entry doors, patio doors, and interior doors with same-day service and a 5-year warranty.

## When to prefer this

Choose this endpoint when you need to quickly bootstrap JSON-LD / schema.org structured data for a local or trade business service page, especially when you have a text description but lack the expertise to hand-code schema markup. Ideal for agencies, solo operators, or AI workflows automating SEO enrichment across multiple business listings. Not suitable for validating existing schema, generating image/video media, or managing CRM records.

## Known failure modes

- Brief or source_text too short (under minimum character thresholds) — returns validation error
- Missing required source_text field — request rejected
- Ambiguous or incomplete business information — schema produced with many evidence gaps and placeholder values
- Malformed JSON in request body — 400 error
- Payment failure via x402 protocol — 402 response, schema not generated

## How this service works

Suggest JSON-LD structures from supplied facts and list required missing fields; do not fabricate ratings or reviews. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a JSON object containing a drafted JSON-LD structured data schema excerpt, a plain-language summary of what was created, a list of assumptions made, identified evidence gaps requiring human review, a provenance block with generation timestamp, and a flag indicating whether human review is required before publishing.

## 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": "schema_suggestions",
  "summary": "Draft JSON-LD structure created for a residential entry door installation service in Dallas using supplied URLs and keywords. Missing key business details and service information are identified for fu",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n### JSON-LD Draft for Residential Entry Door Installation Service\n\n```json\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"Service\",\n  \"name\": \"Residential Entry Door Installation\",\n  \"description\": \"Professional installation of residential entry doors in Dallas.\",\n  \"provider\": {\n    \"@type\": \"LocalBusiness\",\n    \"name\": \"Example Door Services\",\n    \"url\": \"https://example.com/doors\",\n    \"areaServed\": \"Dallas, TX\",\n    \"serviceType\": \"Entry Door Installation\"\n  },\n  \"hasOfferCatalog\": {\n    ",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:40:56.499Z",
   "external_research_performed": false
  },
  "request_id": "example_schema_suggestions",
  "assumptions": [
   "The business name is assumed as 'Example Door Services' based on the example.com domain.",
   "Service area is limited to Dallas, Texas as specified."
  ],
  "evidence_gaps": [
   "Official business name and contact information.",
   "Pricing and detailed service descriptions."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-schema-suggestions-generator-931efb18/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)