---
title: "Search YRUZ glossary, Q&A and articles"
method: GET
path: "/api/search"
tags: ["x402"]
---

# Search YRUZ glossary, Q&A and articles

`GET /api/search`

## Request

- Base URL: `https://yruz.one`
- URL: `https://yruz.one/api/search`
- Auth: none required

No account or API key. Ranked JSON results with excerpts and canonical URLs; without q it returns the newest items. Without PAYMENT-SIGNATURE the response is HTTP 402 with an x402 v2 payment challenge (GET, HEAD and POST all receive it). Price: 0.002 + 0.0005 USDC per result (max 0.02); a query with no results is free.

## Query parameters

- `q` string
- `limit` integer

## Headers

- `PAYMENT-SIGNATURE` string

## Response `200`

Paid search results (or free empty result)

- object
  - `query` string
  - `count` integer
  - `results` object[]
    - `type` 'glossary' | 'question' | 'article'
    - `title` string
    - `url` string
    - `excerpt` string

## Other responses

- `400`: q must be empty or 2-100 characters, limit 1-20
- `402`: Payment Required

---

[API](https://skmtc.dev/yruz/apis/yruz-api.md) · [All operations](https://skmtc.dev/yruz/apis/yruz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yruz/apis/yruz-api/revisions/17883cb21a4a?raw)