# Odysee API
> Live data for Odysee, the decentralised video platform built on the LBRY blockchain — a censorship-resistant YouTube alternative — served straight from the public Odysee/LBRY backend with no key and nothing cached. The channel endpoint resolves a @channel handle to its title, description, avatar and cover art, the number of videos it has published, the LBC staked on it and its tags and languages: @Odysee resolves to the official channel with 134 published claims. The videos endpoint lists a channel's most recent uploads with the title, description, duration, thumbnail, release date and a ready-to-open watch URL. The search endpoint searches the whole platform for videos by keyword, returned in trending order with their channel, title and link. This is the channel-and-video discovery layer for any app building on decentralised, creator-owned video — read live on-chain from the LBRY network, nothing stored. Distinct from centralised-platform and other video APIs — this is the on-chain Odysee/LBRY catalogue. 4 endpoints.

## 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/odysee-api/..."
```

## Pricing
- **Free** (Free) — 12,500 calls/Mo, 3 req/s
- **Starter** ($6/Mo) — 155,000 calls/Mo, 8 req/s
- **Pro** ($15/Mo) — 690,000 calls/Mo, 15 req/s
- **Scale** ($37/Mo) — 3,450,000 calls/Mo, 30 req/s

## Endpoints

### Odysee

#### `GET /v1/channel` — Resolve a channel

**Parameters:**
- `name` (query, required, string) — Channel handle Example: `@Odysee`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/odysee-api/v1/channel?name=%40Odysee"
```

**Response:**
```json
{
    "data": {
        "tags": [
            "odysee",
            "lbry",
            "news",
            "blockchain",
            "education"
        ],
        "cover": "https://thumbs.odycdn.com/7e3550dc3ff08654e4d8d39943ff8ca4.webp",
        "title": "Odysee",
        "avatar": "https://thumbs.odycdn.com/5a920753363de87d6f1f4b0d90b44706.webp",
        "handle": "@Odysee",
        "created": 1600203894,
        "claim_id": "80d2590ad04e36fb1d077a9b9e3a8bba76defdf8",
        "languages": [
            "en"
        ],
        "watch_url": "https://odysee.com/@Odysee:8",
        "lbc_staked": 251402.3807,
        "description": null,
        "video_count": 134
    },
    "meta": {
        "timestamp": "2026-06-09T11:39:51.304Z",
        "request_id": "9b3620c9-1c0a-48bc-8695-ab51a2b11a2e"
    },
    "status": "ok",
    "message": "Channel retrieved successfully",
    "success": true
}
```

#### `GET /v1/search` — Search the platform for videos

**Parameters:**
- `q` (query, required, string) — Search query Example: `bitcoin`
- `limit` (query, optional, string) — How many (default 20, max 50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/odysee-api/v1/search?q=bitcoin&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "query": "bitcoin",
        "videos": [
            {
                "tags": [
                    "discordant dragons",
                    "d&d",
                    "comedy",
                    "cultural commentary",
                    "politics",
                    "c:scheduled:hide"
                ],
                "title": "Discordant Dragons 232 w Pomen and Hunger Merchant",
                "channel": "@Yizz_the_Eunuch",
                "claim_id": "6a05266597709670c5ef0909a00023e7f5fb3e72",
                "thumbnail": "https://thumbs.odycdn.com/e3e0edf8cde66808499746176b1b171d.webp",
                "watch_url": "https://odysee.com/@Yizz_the_Eunuch:e/DD232:6a05266597",
                "description": "Pomen's Twitter: https://x.com/ThePomen\nPomen's Channel: https://www.youtube.com/@Pomen\n\nHunger's Twitter: https://x.com/HungerDye\nHunger's Substack: https://hunger.substack.com/\n\n--\n\nPooTube: https://www.youtube.com/channel/UCGXOHoqaqraxpJwUpQ7qD1w\nRumble: https://rumble.com/c/YizztheEunuch\nSubstack: https://yizztheeunuch.substack.com/\nIntro & elements by Lomax Designs: https://youtu.be/fygRHrWzX",
                "release_time": 1780956000,
                "duration_seconds": 6994
            },
            {
                "tags": [
                    "blockchain",
                    "economics",
                    "bitcoin",
                    "btc",
                    "criptomonedas",
              
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/videos` — A channel's recent uploads

**Parameters:**
- `name` (query, required, string) — Channel handle Example: `@Odysee`
- `limit` (query, optional, string) — How many (default 20, max 50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/odysee-api/v1/videos?name=%40Odysee&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "videos": [
            {
                "tags": [
                    "channel roundup",
                    "channel roundup odysee",
                    "odysee creators",
                    "odysee",
                    "channel roundup creators",
                    "c:scheduled:show"
                ],
                "title": "Channel Roundup: May 2026",
                "channel": "@Odysee",
                "claim_id": "ee58d95e7e42ec9479e13b28d57556f9ffb373dc",
                "thumbnail": "https://thumbs.odycdn.com/54de7817b7cd25f526b368570edd7399.webp",
                "watch_url": "https://odysee.com/@Odysee:8/channel-roundup-may-2026:e",
                "description": "Discover unique channels that create authentic, unfiltered content in this new Channel Roundup.\n\n1. [Maya Clars](https://odysee.com/@mayaclars:4?view=content)\n2. [Fossery Tech](https://odysee.com/@fossery-tech:4?view=content)\n3. [Privacy Guides](https://odysee.com/@PrivacyGuides:c?view=content)\n4. [Efrat Fenigson](https://odysee.com/@Efrat:0?view=content)\n5. [Cooptonian](https://odysee.com/@coopto",
                "release_time": 1780063201,
                "duration_seconds": 413
            },
            {
                "tags": [
                    "channel roundup",
                    "odysee",
                    "odysee creators",
                    "channel roundup odysee",
                    "odysee sync tool (ost)"
                
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/odysee-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Odysee/LBRY public backend (live)",
        "service": "odysee-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/search": "Search the platform for videos (q=bitcoin, limit up to 50), trending order.",
            "GET /v1/videos": "A channel's recent uploads (name=@Odysee, limit up to 50).",
            "GET /v1/channel": "Resolve a channel (name=@Odysee): title, avatar, video count, staked LBC, tags."
        },
        "description": "Live data for Odysee, the decentralised video platform on the LBRY blockchain: resolve a @channel to its title, description, avatar, video count, staked LBC and tags; list a channel's recent uploads with title, duration, thumbnail, release date and watch URL; or search the whole platform for videos by keyword in trending order. Live from the LBRY network, no key, nothing stored. Distinct from centralised-platform video APIs — this is the on-chain Odysee/LBRY catalogue.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T11:39:53.320Z",
        "request_id": "71456190-7fde-4a93-af27-ec70fa05eaaf"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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