# Ysaere Sourced Brief

> Ysaere Sourced Brief is a paid API for AI agents from api.ysaere.com, paid per call via x402, $0.3/call, status unknown (last checked 2026-10-21).

Generates a cited, sourced intelligence brief on a specified market or category, with optional focus angle and caller context

## Facts

- Endpoint: POST https://api.ysaere.com/v1/intel/sourced-brief?utm_source=zero.xyz
- Price: $0.3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ysaere-sourced-brief-2276a80b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8nyJZgUPul7a0K-tDpJaJ

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 ysaere-sourced-brief-2276a80b -d '<json body>'
```

Example prompt: Pull me a cited market brief on the US defense drone market, focusing on pricing and top vendors — include your sources.

## When to prefer this

Choose this endpoint when you need a narrative intelligence brief with cited sources on a market or category — not just raw search results or data points. It is preferable over the Ysaere quick brief when you need citations and sourcing for credibility or downstream verification. Use it over generic web search when you want a synthesized, analyst-style summary rather than a list of links. Best for due diligence, competitive research, pitch prep, or sector onboarding where referenced conclusions matter.

## Known failure modes

- Empty or very niche target market with insufficient source coverage may return a sparse brief or empty sources list
- Overly long context or focus strings exceeding character limits will be rejected with a 400-level error
- Payment failure or insufficient USDC balance will result in a 402 Payment Required response
- Ambiguous or malformed target field may produce a generic or off-topic brief
- Timeouts possible if source aggregation takes longer than expected under load

## How this service works

Ysaere sourced brief — cited sync brief (USDC)

## Output

Returns a JSON object with a 'success' boolean and a 'data' object containing a 'brief' string (the full intelligence brief narrative) and a 'sources' array listing the citations used to compile it.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "focus": {
   "type": "string",
   "maxLength": 500,
   "description": "Optional angle, e.g. \"pricing and top vendors\""
  },
  "target": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1,
   "description": "Market or category, e.g. \"US defense drone market\", \"stablecoin payments in LATAM\""
  },
  "context": {
   "type": "string",
   "maxLength": 4000,
   "description": "Optional caller notes"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "brief": "...",
   "sources": []
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ysaere-sourced-brief-2276a80b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ysaere.com](https://www.zero.xyz/host/api.ysaere.com/llms.txt)