# StatePulse Brand Assets Lookup

> StatePulse Brand Assets Lookup is a paid API for AI agents from statepulse-api.hahavoid0.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Retrieves logo URL and brand color palette for a given company or domain name

## Facts

- Endpoint: POST https://statepulse-api.hahavoid0.workers.dev/brand/assets
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/statepulse-brand-assets-lookup-f5e7e173
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tmLb2W0K-r-C6A-xe3KiB

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 statepulse-brand-assets-lookup-f5e7e173 -d '<json body>'
```

Example prompt: Can you fetch the logo and brand colors for Spotify — I need the logo URL and the hex color codes so I can match the visual style in my design.

## When to prefer this

Choose this endpoint when you need to programmatically retrieve a brand's logo URL and official color palette by company name or domain, especially in no-account pay-per-call scenarios using x402 USDC on Base. Prefer this over scraping or manual lookup when building design tools, dashboards, or agent workflows that need to auto-populate visual brand identity data.

## Known failure modes

- Unknown or unsupported brand returns supported:false with empty or null logo and colors
- Low-confidence results may return incorrect or generic logo/colors
- Invalid or malformed domain/brand name may return an error or low-confidence result
- Network timeout from upstream logo provider (e.g. Clearbit) causes delayed or failed response
- Payment failure via x402/USDC results in 402 response before any brand data is returned

## How this service works

Extracts brand logos and theme colors for any public business URL using Clearbit and HTML parsing.

## Output

Returns a JSON object with a `result` containing a `logo` field (URL string to the brand's logo image) and a `colors` array of hex color code strings, plus a `supported` boolean indicating if the brand is recognized and a `confidence` string ('high', 'medium', or 'low') indicating lookup reliability.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "logo": "https://logo.clearbit.com/spotify.com",
   "colors": [
    "#1db954"
   ]
  },
  "supported": true,
  "confidence": "high"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/statepulse-brand-assets-lookup-f5e7e173/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from statepulse-api.hahavoid0.workers.dev](https://www.zero.xyz/host/statepulse-api.hahavoid0.workers.dev/llms.txt)
