# AdPrompt Brand Scan

> AdPrompt Brand Scan 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).

Scans a website URL to extract brand identity and business context metadata, gated behind a $0.01 USDC x402 micropayment

## Facts

- Endpoint: POST https://x402.adprompt.io/v1/brand-scan
- 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-brand-scan-b541251d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zDvzstWmr0-DZ-TR_E1ow

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-brand-scan-b541251d -d '<json body>'
```

Example prompt: Can you do a brand scan on nike.com and pull back their brand identity and business context metadata — save the profile so I can use it again later?

## When to prefer this

Use this endpoint when you need structured brand identity and business context data extracted directly from a live website URL, especially in advertising or marketing automation workflows where x402 micropayment infrastructure is already in place. Prefer it over manual research or general web scraping when you need AdPrompt-formatted brand metadata compatible with downstream AdPrompt ad generation and campaign analysis endpoints.

## Known failure modes

- 402 Payment Required — endpoint returns an x402 v2 challenge if no valid payment is supplied; agent must complete micropayment flow first
- Invalid website URL — malformed or unreachable URLs may cause extraction failure
- Profile not found — supplying an invalid profile_id for refresh returns an error
- Timeout — slow-loading websites may cause the scan to fail or return incomplete data

## 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 with ok=true, a product_id, receipt_id, price_usd, a result object containing extracted brand data, metadata including business context and creative assets, and optionally a saved_profile with name, website, and profile_id for future use.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "website": {
   "type": "string",
   "description": "Business website for ProfileFromUrls. Optional when manual_business_profile or profile_id is provided."
  },
  "profile_id": {
   "type": "string",
   "description": "Optional existing profile id to refresh after payment."
  },
  "save_profile": {
   "type": "boolean",
   "description": "Deprecated for Brand Scan. Successful Brand Scan results always upsert the wallet profile."
  },
  "wallet_address": {
   "type": "string"
  },
  "manual_business_profile": {
   "type": "object",
   "description": "Manual business details for ProfileFromInputs when no website is available."
  }
 }
}
```

## 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-brand-scan-b541251d/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)