# oEmbed Lookup

> oEmbed Lookup is a paid API for AI agents from intel.rallylive.ca, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches oEmbed metadata (title, author, thumbnail, dimensions, embed HTML) for a media URL from YouTube, Vimeo, TikTok, SoundCloud, Spotify, Flickr, Bluesky, Reddit, and any oEmbed-compatible site.

## Facts

- Endpoint: GET https://intel.rallylive.ca/data/oembed
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oembed-lookup-604b070e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WgCSsWKYwmr4oKtJyDNFO

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 oembed-lookup-604b070e
```

Example prompt: Can you fetch the oEmbed metadata for this YouTube video — https://www.youtube.com/watch?v=dQw4w9WgXcQ — I need the title, author, thumbnail URL, and the embed HTML?

## When to prefer this

Use this endpoint when you need rich media metadata and embed HTML for a known media URL from platforms like YouTube, Vimeo, TikTok, SoundCloud, Spotify, Flickr, Bluesky, or Reddit, and you want a single normalized response without scraping the page yourself. Prefer it over manual HTML scraping when you need the canonical embed code and author info as provided by the media platform itself.

## Known failure modes

- URL does not belong to a site with an oEmbed endpoint — returns error or empty result
- Private or deleted media URL — oEmbed provider returns 404 or 403
- Malformed URL input — returns validation error
- oEmbed provider is temporarily unavailable — timeout or 5xx error
- URL is valid but provider does not return embed HTML (link type oEmbed only)

## How this service works

oEmbed lookup for a media URL: title, author, provider, thumbnail, dimensions and embed HTML for YouTube, Vimeo, TikTok, SoundCloud, Spotify, Flickr, Bluesky, Reddit and any site that advertises an oEmbed endpoint. $0.01 per URL.

## Output

Returns structured oEmbed data including: title, author name, author URL, provider name, provider URL, thumbnail URL, thumbnail dimensions, content dimensions (width/height), oEmbed type (video/photo/rich/link), and the embed HTML snippet ready for insertion into a webpage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oembed-lookup-604b070e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from intel.rallylive.ca](https://www.zero.xyz/host/intel.rallylive.ca/llms.txt)