# Share Card Metadata Lookup

> Share Card Metadata Lookup is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Fetches and normalizes a web page's Open Graph, Twitter Card, title, favicon, canonical URL, and author metadata into a single JSON object for any given URL.

## Facts

- Endpoint: POST https://x402.forgemesh.io/share-card-metadata
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/share-card-metadata-lookup-c6c581fe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bBHiAduLXhShEZjDLkjXo

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 share-card-metadata-lookup-c6c581fe -d '<json body>'
```

Example prompt: Can you pull the social share metadata for https://openai.com — I want to see the Open Graph title, description, image, canonical URL, author, and favicon all in one place?

## When to prefer this

Use this endpoint when you need to quickly inspect how a URL will render as a social share card — including Open Graph and Twitter Card tags — without building a custom scraper. Ideal for SEO audits, CMS link-preview features, content moderation pipelines, or any workflow that needs normalized social metadata from arbitrary URLs.

## Known failure modes

- URL points to an internal/private IP address — blocked for security, returns error
- URL is unreachable or returns a non-200 HTTP status
- Page has no Open Graph or Twitter Card tags — returns partial metadata with only available fields
- Malformed or invalid URL input — returns validation error
- Page requires authentication to access — returns limited or empty metadata

## How this service works

Social share metadata lookup: reads a web page's title, canonical link, favicon, author, and social-card tags (Open Graph and Twitter formats) and returns them as one normalized JSON object. Safe against internal-address requests. Handy for SEO checks, content management systems, and any tool that needs to know how a URL will look when shared.

## Output

A normalized JSON object containing the page's title, canonical link, favicon URL, author, and all Open Graph and Twitter Card meta tags extracted from the given URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "og:title": "Micropayment",
   "description": "A micropayment is a financial transaction involving a very small sum of money..."
  },
  "title": "Micropayment - Wikipedia",
  "canonical": "https://en.wikipedia.org/wiki/Micropayment"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/share-card-metadata-lookup-c6c581fe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)