# YRUZ Profile Lookup

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

Retrieves a YRUZ social network user's public profile by username

## Facts

- Endpoint: GET https://yruz.one/api/profile?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yruz-profile-lookup-390a585a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H-8vcD8WebakHEeX5A2cM

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-profile-lookup-390a585a
```

Example prompt: Can you pull up the YRUZ profile for the username 'alex_creator'?

## When to prefer this

Use this endpoint when you need to programmatically retrieve a specific user's public profile from the YRUZ social network by their exact username. Prefer this over manual web browsing when automating identity verification, community research, or aggregating social data about YRUZ members.

## Known failure modes

- Username not found — returns error or empty data if the username does not exist on YRUZ
- Missing required 'username' query parameter — request will fail without it
- Private or restricted profile — may return limited or no data
- Network timeout or service unavailability — standard HTTP errors

## 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

Returns a JSON object containing the public profile data for the requested YRUZ username, including fields such as profile details and other publicly visible account information (exact fields indicated by the 'data' key in the response).

## 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": [
      "username"
     ],
     "properties": {
      "username": {
       "type": "string",
       "description": "YRUZ username (required)"
      }
     }
    }
   },
   "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-profile-lookup-390a585a/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)