# YRUZ DNS Lookup API

> YRUZ DNS Lookup API 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).

Performs DNS record lookups for a given domain, returning one or all record types.

## Facts

- Endpoint: POST https://yruz.one/api/util/dns?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-dns-lookup-api-760165a1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5dVeKdvXkK_t_zhS_Ipc4

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-dns-lookup-api-760165a1 -d '<json body>'
```

Example prompt: Can you look up all the DNS records for github.com and tell me what you find?

## When to prefer this

Use this endpoint when you need a quick, pay-per-call DNS lookup without setting up your own DNS resolution infrastructure. It is well-suited for agents that occasionally need to verify domain configuration, check mail records, or inspect infrastructure details without requiring a dedicated DNS library or server access. At $0.002 per call it is cost-effective for infrequent lookups.

## Known failure modes

- Domain not found or non-existent — empty result object returned
- Invalid domain format — may return error or empty result
- Unsupported record type string — may return empty or error
- Network timeout on DNS resolution — request may fail or hang
- Rate limiting if too many queries are made in quick succession

## 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 DNS records for the queried domain, keyed by record type (e.g. A, MX, CNAME, TXT, NS). When record type is ALL or omitted, all available record types are returned. The result field is an object containing the resolved records.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "type": "string",
   "description": "record type or ALL (default ALL)"
  },
  "domain": {
   "type": "string",
   "description": "domain (required)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "dns",
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yruz-dns-lookup-api-760165a1/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)