# Bazaar Gateway URL Preview

> Bazaar Gateway URL Preview is a paid API for AI agents from bazaar-gateway.vercel.app, paid per call via x402, $0.001/call, status down (last checked 2026-10-12).

Extracts OpenGraph and Twitter Card metadata (title, description, image, favicon, canonical URL, language) from any public URL

## Facts

- Endpoint: GET https://bazaar-gateway.vercel.app/api/url-preview?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bazaar-gateway-vercel-app-a1773ece
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oV6h_T3fv3QEH0pz1jIf4

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 bazaar-gateway-vercel-app-a1773ece
```

Example prompt: Can you grab the title, description, and preview image for this link: https://techcrunch.com/2024/01/15/openai-announces-new-model/ — I just need the OpenGraph metadata, nothing deep.

## When to prefer this

Use this endpoint when you need to quickly scan one or more URLs for their metadata before deciding whether to invest in deeper analysis. At $0.001 per call it is 5x cheaper than the full AI web-intelligence endpoint ($0.005). Ideal for filtering, ranking, or enriching a list of links with titles/images/descriptions without parsing full page content. Choose the sibling /api/web-intelligence endpoint when you need actual page content, entity extraction, or sentiment analysis.

## Known failure modes

- URL is not publicly accessible (private or behind auth) — returns ok:false
- URL does not exist or returns 4xx/5xx — returns ok:false with error
- URL has no OpenGraph or Twitter Card metadata — returns ok:true but og/twitter fields are null
- Timeout if the target server is slow (latency up to 800ms)
- Invalid URL format — missing required query param or malformed URL

## How this service works

Fast link preview extractor — returns OpenGraph/Twitter Card metadata (title, description, image, favicon, site name, canonical URL, language) for any public URL. Perfect for agents that need to scan many links quickly before deciding which ones deserve deep analysis via /api/web-intelligence ($0.005). 5x cheaper than full AI analysis. Latency ~300-800ms.

## Output

Returns a structured object with: ok (boolean), url and final_url (after redirects), title, description, image (absolute URL), favicon, site_name, language, canonical URL, og object (OpenGraph fields), twitter object (Twitter Card fields), article metadata (author, published_at, section, tags), signals object (boolean flags for has_og_image, has_twitter_card, has_canonical, has_favicon, has_article_metadata, content_type_inferred enum), redirects count, fetched_at timestamp, _meta with call_id, and HATEOAS next actions suggesting deeper analysis endpoints.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "url": "https://www.wikipedia.org"
  }
 }
}
```

## 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",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "Full URL to preview (http:// or https://)"
      }
     }
    }
   },
   "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/bazaar-gateway-vercel-app-a1773ece/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bazaar-gateway.vercel.app](https://www.zero.xyz/host/bazaar-gateway.vercel.app/llms.txt)
