# Get URL

> Get URL is a paid API for AI agents from api.gadgethumans.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-20).

Fetches any web page by URL and returns its content as clean readable text, along with the page title, meta description, HTTP status code, and byte count.

## Facts

- Endpoint: GET https://api.gadgethumans.com/get-url?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/get-url-a390bbae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EhHc3GjRl658ttBBS9dwY

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 get-url-a390bbae
```

Example prompt: Can you fetch the content of https://example.com/article and give me the readable text along with the page title and HTTP status?

## When to prefer this

Use this endpoint when you need the readable text content of a web page without dealing with raw HTML parsing. It is ideal for reading articles, documentation, or public API responses as plain text. Prefer this over raw HTTP fetch tools when you want structured metadata (title, description, status, byte count) returned alongside the content automatically. Best suited for publicly accessible pages that do not require JavaScript rendering or authentication.

## Known failure modes

- URL is unreachable or returns a non-200 status — ok may be false with the HTTP status reflected
- URL points to a binary file (PDF, image) rather than HTML — text extraction may be empty or garbled
- URL requires authentication or returns a 401/403 — content will be unavailable
- URL is malformed or missing scheme — request will fail with a validation error
- Page uses heavy JavaScript rendering — server-side content only is returned, dynamic content may be missing
- Rate limiting or firewall on the target server blocks the fetch request

## How this service works

Get the URL: fetch any web address and return its content as clean readable text, with the page title, meta description, HTTP status and byte count. Use when you need the contents of a page, article, documentation or API response as text rather than raw HTML. Query parameter url is the absolute address to fetch.

## Output

A JSON object with an 'ok' boolean plus the page's clean readable text content, page title, meta description, HTTP status code, and total byte count of the response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "properties": {
   "ok": {
    "type": "boolean"
   }
  }
 },
 "example": {
  "ok": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/get-url-a390bbae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gadgethumans.com](https://www.zero.xyz/host/api.gadgethumans.com/llms.txt)
