Extract metadata from URLs for rich link previews.

Endpoint

Request / Response

// Request (query params)
{
  url: string;  // URL to extract metadata from
}

// Response
interface OpenGraphMeta {
  title?: string;       // Page title
  description?: string; // Meta description
  image?: string;       // og:image URL
  siteName?: string;    // og:site_name
  type?: string;        // og:type (article, website, etc.)
  url?: string;         // Canonical URL
}

Implementation

import { newgraphClient } from "newgraph-signals";

// Fetch URL metadata
const targetUrl = "https://example.com/article";
const response = await newgraphClient.api.post.utilsRemoteMetaProxyList({
  url: targetUrl
});

const meta = response.data;

console.log("Title:", meta.title);
console.log("Description:", meta.description);
console.log("Image:", meta.image);

React Hook Pattern

import { useOpenGraph } from "newgraph-signals/hooks";

function LinkPreview({ url }) {
  const { data, loading, error } = useOpenGraph(url);
  
  if (loading) return <div>Loading preview...</div>;
  if (error) return <div>Could not load preview</div>;
  
  return (
    <div className="link-preview">
      {data.image && <img src={data.image} alt="" />}
      <h3>{data.title}</h3>
      <p>{data.description}</p>
      <span>{data.siteName}</span>
    </div>
  );
}

Why Server Proxy?

Use Cases

Edge Cases