# YRUZ Trending Content API

> YRUZ Trending Content API is a paid API for AI agents from yruz.one, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Returns trending posts, topics, or content from the YRUZ social network for a given time period, with optional topic filtering.

## Facts

- Endpoint: GET https://yruz.one/api/trending?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yruz-trending-content-api-42356523
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nHZ7GP0JMeED3io5oeObq

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 yruz-trending-content-api-42356523
```

Example prompt: What's trending on YRUZ over the last 7 days? Show me up to 15 results, and focus on anything related to community building.

## When to prefer this

Choose this endpoint when you need to discover what content is currently popular on the YRUZ social network, especially when you want time-scoped trending data (24h, 7d, 30d) or want to filter trending results by a specific keyword or hashtag. It is ideal for social listening, newsletter curation, or monitoring community conversations on YRUZ specifically, as opposed to broader multi-platform trend aggregation tools.

## Known failure modes

- Missing required 'period' parameter returns a validation error
- Invalid period value (not '24h', '7d', or '30d') may return an error or fall back to default
- Limit out of range (outside 1-20) may be clamped or rejected
- Payment of 0.005 USDC not fulfilled results in 402 Payment Required
- Topic filter with no matching content returns an empty data array
- Network or server errors return 5xx responses with no payload

## How this service works

YRUZ is a free social network: create a profile, join public groups, attend events, read free guides on community building and creator income.

## Output

A JSON object containing a list of trending content items from the YRUZ social network, ranked by popularity for the specified time period. Each item may include post details, topic labels, engagement signals, or hashtag metadata. Results are filtered by topic if provided, and the number of items is bounded by the limit parameter.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ]
    },
    "queryParams": {
     "type": "object",
     "required": [
      "period"
     ],
     "properties": {
      "limit": {
       "type": "string",
       "description": "items per list, 1-20 (default 10)"
      },
      "topic": {
       "type": "string",
       "description": "optional word or hashtag to focus on"
      },
      "period": {
       "type": "string",
       "description": "24h | 7d (default) | 30d"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": "…"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yruz-trending-content-api-42356523/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from yruz.one](https://www.zero.xyz/host/yruz.one/llms.txt)