# URL Tools API
> Unfurl link previews — title, description, image, site name and favicon (Open Graph + meta tags) — and expand / unshorten URLs by following redirects to their final destination. Perfect for chat unfurls, link cards and resolving short links.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/url-api/..."
```

## Pricing
- **Free** (Free) — 300 calls/Mo, 1 req/s
- **Basic** ($7/Mo) — 40,000 calls/Mo, 5 req/s
- **Pro** ($21/Mo) — 220,000 calls/Mo, 15 req/s
- **Mega** ($69/Mo) — 1,200,000 calls/Mo, 40 req/s

## Endpoints

### URL

#### `GET /v1/expand` — Expand / unshorten a URL

**Parameters:**
- `url` (query, required, string) — URL to follow Example: `https://github.com`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/url-api/v1/expand?url=https%3A%2F%2Fgithub.com"
```

**Response:**
```json
{
    "data": {
        "url": "https://github.com/",
        "status": 200,
        "final_url": "https://github.com/",
        "redirected": false
    },
    "meta": {
        "timestamp": "2026-05-30T01:37:03.311Z",
        "request_id": "f72734a2-d199-4729-aa44-927b58305ac5"
    },
    "status": "ok",
    "message": "URL expanded successfully",
    "success": true
}
```

#### `GET /v1/preview` — Link preview / unfurl

**Parameters:**
- `url` (query, required, string) — URL to unfurl Example: `https://github.com`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/url-api/v1/preview?url=https%3A%2F%2Fgithub.com"
```

**Response:**
```json
{
    "data": {
        "url": "https://github.com/",
        "type": "object",
        "image": "https://images.ctfassets.net/8aevphvgewt8/4pe4eOtUJ0ARpZRE4fNekf/f52b1f9c52f059a33170229883731ed0/GH-Homepage-Universe-img.png",
        "title": "GitHub · Change is constant. GitHub keeps you ahead.",
        "favicon": "https://github.com/fluidicon.png",
        "final_url": "https://github.com/",
        "site_name": "GitHub",
        "description": "Join the world's most widely adopted, AI-powered developer platform where millions of developers, businesses, and the largest open source community build software that advances humanity."
    },
    "meta": {
        "timestamp": "2026-05-30T01:37:03.784Z",
        "request_id": "f7e153ea-64fb-4c3d-b777-68214156ddb7"
    },
    "status": "ok",
    "message": "Preview retrieved successfully",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/url-api
OpenAPI spec: https://www.oanor.com/api/url-api/openapi.json