Fetch link previews for one or more URLs.
Accepts an array of URLs and returns Open Graph / meta tag preview data for each. Each preview is signed with an HMAC-SHA256 signature that must be included when the preview is submitted with a chat message. Nurama verifies the signature when the message is created, to prevent spoofed preview data. Duplicate URLs are collapsed and URLs that fail validation, fetching or SSRF checks are silently omitted from `previews`, so the array may be shorter than the input. Rate limited to 30 requests per minute per IP. Requires authentication.
Accepts an array of URLs and returns Open Graph / meta tag preview data for each. Each preview is signed with an HMAC-SHA256 signature that must be included when the preview is submitted with a chat message. Nurama verifies the signature when the message is created, to prevent spoofed preview data.
Duplicate URLs are collapsed and URLs that fail validation, fetching or
SSRF checks are silently omitted from previews, so the array may be
shorter than the input. Rate limited to 30 requests per minute per IP.
Requires authentication.
Authorization
bearerAuth In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/link-preview" \ -H "Content-Type: application/json" \ -d '{ "urls": [ "https://github.com", "https://example.com" ] }'{ "previews": [ { "url": "http://example.com", "title": "string", "description": "string", "image": "http://example.com", "siteName": "string", "favicon": "http://example.com", "signature": "string" } ]}