Name: Meta Preview API — Extract Open Graph, Twitter Card & SEO Meta Tags
Brand: sitetrace
SKU: api-sitetrace-meta-preview
Availability: InStock
Author: API Market

Edy Appenzeller

## Meta Preview API — Extract Open Graph, Twitter Card & SEO Meta Tags

Instantly fetch every meta tag from any public webpage with a single API call. The Meta Preview API extracts Open Graph properties, Twitter Card data, canonical URLs, meta robots directives, hreflang tags, JSON-LD structured data, and dozens of standard HTML meta fields — giving you the complete SEO metadata picture for any URL on the internet.

Whether you're building a link-preview widget, auditing competitor SEO, monitoring social sharing metadata, or populating a content-intelligence dashboard, this API gives you structured, clean data without the overhead of running your own scraper.

---

## What Does This API Do?

Submit any URL and receive a fully structured metadata response containing:

- **Open Graph tags** (og:title, og:description, og:image, og:type, og:url, og:site_name, og:locale)
- **Twitter Card tags** (twitter:card, twitter:title, twitter:description, twitter:image, twitter:site, twitter:creator)
- **Standard HTML meta** (description, keywords, author, viewport, robots, generator)
- **Canonical URL** and alternate/hreflang links
- **JSON-LD structured data** (schema.org objects embedded in the page)
- **HTTP metadata** (final URL after redirects, status code, response time)
- **Favicon URL**
- **Content language** detected from HTTP headers and HTML attributes

---

## Key Features

### ✅ Complete Meta Extraction
Pulls every Open Graph, Twitter Card, and standard meta tag from the page's `<head>` section in one pass. No more building your own Cheerio scrapers — get clean, structured JSON.

### ✅ Social Preview Data
Perfect for building Slack-style link unfurling or Facebook/LinkedIn-style share previews. The API returns the exact same data social platforms use when generating previews.

### ✅ JSON-LD Support
Extracts embedded structured data (schema.org) from `<script type="application/ld+json">` blocks — useful for detecting Article, Product, BreadcrumbList, FAQPage, and other schema types.

### ✅ Redirect Tracking
Follows HTTP redirects and returns the final resolved URL alongside the original. Essential for tracking link shorteners and UTM redirect chains.

### ✅ Plan-Based Data Depth
Free plan returns core OG and Twitter data. Paid plans unlock JSON-LD objects, hreflang arrays, full HTTP header metadata, and extended structured data fields.

---

## Use Cases

**Link Preview Widgets** — Build Slack/Discord-style link cards that show title, description, and thumbnail image when users share URLs in your app.

**SEO Auditing Tools** — Check whether pages have correct og:image dimensions, canonical tags, robots directives, and Twitter Card types across large URL lists.

**Content Aggregators** — Automatically enrich articles with metadata when users submit links — extract author, publish date, and section from JSON-LD.

**Social Media Monitoring** — Verify that your pages present the correct preview data before publishing campaigns to Facebook, LinkedIn, or Twitter.

**Competitor Intelligence** — Scrape keyword signals, meta descriptions, and structured data from competitor pages to inform your own SEO strategy.

**Browser Extensions** — Power instant metadata inspection tools that show SEO and social meta on any page with a single click.

---

## API Reference

**Endpoint:** `POST /api/meta-preview`

**Base URL:** `https://prod.api.market/v1/sitetrace/meta-preview`

### Request Body

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| url | string | ✅ Yes | The full URL to extract meta tags from |

### Example Request

```bash
curl -X POST https://prod.api.market/v1/sitetrace/meta-preview \
  -H "Content-Type: application/json" \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -d '{"url": "https://example.com/article"}'
```

### Example Response

```json
{
  "success": true,
  "data": {
    "url": "https://example.com/article",
    "final_url": "https://example.com/article",
    "status_code": 200,
    "title": "Example Article Title",
    "description": "A concise description of the article content",
    "canonical": "https://example.com/article",
    "robots": "index, follow",
    "open_graph": {
      "og:title": "Example Article Title",
      "og:description": "A concise description of the article content",
      "og:image": "https://example.com/images/article-hero.jpg",
      "og:type": "article",
      "og:url": "https://example.com/article",
      "og:site_name": "Example Site"
    },
    "twitter_card": {
      "twitter:card": "summary_large_image",
      "twitter:title": "Example Article Title",
      "twitter:description": "A concise description of the article content",
      "twitter:image": "https://example.com/images/article-hero.jpg",
      "twitter:site": "@examplesite"
    },
    "favicon": "https://example.com/favicon.ico",
    "language": "en",
    "json_ld": [{ "@type": "Article", "headline": "Example Article Title" }],
    "plan": "pro"
  }
}
```

---

## Pricing Plans

| Plan | Price | Monthly Calls | Overage |
|------|-------|---------------|---------|
| Basic | $0/mo | 50 calls | None (hard limit) |
| Plus | $4.99/mo | 200 calls | $0.001/call |
| Pro | $9.99/mo | 1,000 calls | $0.001/call |
| Ultra | $29.99/mo | 5,000 calls | $0.001/call |
| Mega | $99.99/mo | 20,000 calls | $0.001/call |

---

## Why Use SiteTrace Meta Preview API?

- **No browser required** — Server-side HTTP fetch, no Puppeteer or headless Chrome overhead
- **Structured JSON output** — Every tag parsed into a clean, typed object
- **Fast response times** — Optimized fetch with redirect tracking, typically under 2 seconds
- **Production-ready** — Built on the SiteTrace API Suite infrastructure serving thousands of requests daily
- **Generous free tier** — Start for free with 50 calls/month, no credit card required

Fetch Open Graph tags, Twitter Cards, canonical URLs, JSON-LD structured data, and all HTML meta tags from any URL. Build link previews, audit SEO metadata, and extract social sharing data at scale.

Meta Preview API — Extract Open Graph, Twitter Card & SEO Meta Tags

Basic