# 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 page title, meta description, HTTP status code, and byte count.

## Facts

- Endpoint: GET https://api.gadgethumans.com/geturl?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-2b3bcf76
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TD8A66vZRNj5W_k9iRRLX

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-2b3bcf76
```

Example prompt: Can you fetch the content of https://en.wikipedia.org/wiki/Artificial_intelligence and give me the page title, meta description, and readable text?

## When to prefer this

Use this endpoint when your agent needs to read the text content of any public web page — especially for real-time information retrieval, fact-checking against live URLs, summarizing articles, or checking page metadata. Prefer this over a search API when you already have the specific URL and need its content directly. It is distinct from a full browser automation tool since it returns clean text rather than rendered HTML or screenshots.

## Known failure modes

- URL is unreachable or times out — HTTP error status returned
- URL returns a non-200 status (e.g. 404 Not Found, 403 Forbidden) — status code reflected in response
- URL points to binary content (PDF, image, video) — text extraction may be empty or garbled
- Malformed or relative URL provided — request fails validation
- Page is behind a login wall or CAPTCHA — returns limited or no text content
- URL schema not absolute (missing https://) — validation error

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

## Output

Returns a JSON object with: a boolean ok status, the page title, meta description, HTTP status code, byte count of the response, and the full page content extracted as clean readable text stripped of HTML markup.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "Absolute URL to fetch"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "ok": true
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/get-url-2b3bcf76/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)
