Nurama Developers
Link Preview

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. The backend verifies the signature on message creation 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.

POST
/link-preview

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. The backend verifies the signature on message creation 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

AuthorizationBearer <token>

OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.

In: header

Scope: chat:write

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"    }  ]}