# AdPrompt Competitive Analysis API

> AdPrompt Competitive Analysis API is a paid API for AI agents from x402.adprompt.io, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-16).

Performs an AI-powered competitive analysis for a business, returning strategic insights about competitors, market positioning, and brand landscape via x402 micropayment-gated endpoint.

## Facts

- Endpoint: POST https://x402.adprompt.io/v1/competitive-analysis
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/adprompt-competitive-analysis-api-49700b36
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Jm9YTdcAj4kXDhxhVX7Jv

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 adprompt-competitive-analysis-api-49700b36 -d '<json body>'
```

Example prompt: Run a competitive analysis for my business at acmeshoes.com — save the profile so I don't need to re-scan — and tell me who my main competitors are and how we compare.

## When to prefer this

Choose this endpoint when you need structured, AI-generated competitive intelligence for a specific business and are operating in an x402 micropayment-capable environment. It is ideal for agents that already have a business profile_id stored from a prior AdPrompt scan, or can provide a website URL for a fresh brand scan. Prefer this over generic web search when you need a pre-formatted, structured JSON competitive analysis bundle ready for downstream agent consumption.

## Known failure modes

- 402 Payment Required — no valid x402 payment header supplied; endpoint returns a challenge until payment is provided
- Missing required input — neither website nor profile_id nor manual_business_profile provided, resulting in a validation error
- Website scan failure — if the provided URL is unreachable or returns no meaningful content, the brand scan step may fail
- Invalid wallet address — malformed wallet address may cause payment or receipt processing errors
- Rate limiting or upstream AI failure — competitive analysis generation may time out or return an error if the AI backend is overloaded

## How this service works

Public x402 API for the full AdPrompt engine and bundle catalog. Paid endpoints return an x402 v2 402 challenge until a valid payment is supplied.

## Output

Returns a JSON object containing the competitive analysis result (competitor names, positioning insights, market landscape), business context metadata, creative metadata, a receipt ID confirming the x402 micropayment, a product ID, the price paid in USD, and optionally a saved profile object with profile_id, name, and website for future reuse.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "website": {
   "type": "string",
   "description": "If no profile is available, this adds a required paid Brand Scan."
  },
  "profile_id": {
   "type": "string"
  },
  "save_profile": {
   "type": "boolean"
  },
  "wallet_address": {
   "type": "string"
  },
  "manual_business_profile": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ok",
  "status",
  "product_id",
  "receipt_id",
  "request_id",
  "result_url",
  "report_url"
 ],
 "properties": {
  "ok": {
   "type": "boolean",
   "const": true
  },
  "label": {
   "type": "string"
  },
  "job_id": {
   "type": "string",
   "description": "Present only for the asynchronous video product."
  },
  "status": {
   "type": "string",
   "const": "queued"
  },
  "product_id": {
   "type": "string"
  },
  "receipt_id": {
   "type": "string"
  },
  "report_url": {
   "type": "string",
   "description": "Fetch this once background processing completes for the full AdPrompt-branded report."
  },
  "request_id": {
   "type": "string"
  },
  "result_url": {
   "type": "string",
   "const": "/results"
  },
  "polling_url": {
   "type": "string",
   "description": "Present only for the asynchronous video product."
  },
  "saved_profile": {
   "type": "object",
   "properties": {
    "name": {
     "type": "string"
    },
    "website": {
     "type": "string",
     "format": "uri"
    },
    "profile_id": {
     "type": "string"
    }
   },
   "additionalProperties": true
  },
  "business_context": {
   "type": "object"
  },
  "adprompt_signature": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/adprompt-competitive-analysis-api-49700b36/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.adprompt.io](https://www.zero.xyz/host/x402.adprompt.io/llms.txt)