Skip to content

Link Preview

v1.0.0

Unfurl any URL into the title, description, image and favicon needed to render a link card.

1 endpoint
Price per call
$0.001
Free each month
500 calls
Rate limit
120/min
MCP server
Included

Overview

Link Preview turns a URL into the card that every chat app, CMS and social product renders when someone pastes a link.

The difficult part is not reading og:title. It is that most of the web has incomplete OpenGraph markup, so a service that only reads og: tags returns empty cards for a large share of real links. Every field here falls back through a chain: OpenGraph, then Twitter card tags, then standard meta tags, then the document itself. Titles fall back to <title>, images to the Twitter card, favicons to the conventional /favicon.ico when none is declared.

URLs are resolved to absolute addresses against the final URL after redirects, so an image referenced relatively still works once the card is rendered somewhere else.

Make your first call

Every request goes through the Twotic gateway, which authenticates your key, applies the rate limit, meters the call and forwards it. The exact amount charged comes back on the X-Twotic-Cost header.

curl -X GET "https://www.twotic.dev/v1/link-preview/preview" \
  -H "Authorization: Bearer $TWOTIC_KEY"

Endpoints

What you can build

Render link cards in a chat or comment feed

Unfurl on paste, store the result against the URL, and render from your own copy. One call per unique link rather than one per impression.

Populate a bookmark or read-later tool

Title, description, image and site name are exactly the fields a saved-link UI needs, and they arrive in one request instead of a fetch-and-parse you have to maintain.

Pre-fill a CMS when an editor pastes a source URL

Author, published date and description come back alongside the visual fields, removing most of the manual typing from citing an external source.

Use Link Preview from an AI agent

Every endpoint above is also an MCP tool. Pick your client and the steps below fill in with this API’s real server URL, so there is nothing to substitute.

In claude.ai and the Claude desktop app

  1. 1Open Settings, then Connectors.
  2. 2Choose Add custom connector.
  3. 3Paste the server URL below and confirm.
  4. 4A Twotic sign-in page opens. Approve the connection.
  5. 5Start a new conversation. The tools are available there.

Server URL

https://www.twotic.dev/api/mcp/link-preview

Signs you in through Twotic. Access expires hourly and renews itself, and you can revoke this one app without touching your API keys.

Once connected, the tools are named link-preview_<endpoint>. Every Link Preview endpoint becomes one. Calls are metered exactly like an HTTP request, against the same allowance and balance.

Frequently asked

What happens if a page has no OpenGraph tags at all?+

You still get a usable card. The title falls back to the document's <title>, the site name to its hostname, and the favicon to /favicon.ico. Fields with no available source come back as null rather than invented.

Does it follow redirects?+

Yes, up to five hops, and every hop is re-checked against private address ranges. The returned url is the final destination, which is what you should store — link shorteners otherwise leave you with a preview whose URL no longer matches its content.

Should I cache the result?+

Yes. Page metadata changes rarely, and caching by URL is the difference between one call per link and one call per view. Nothing is cached on our side, so the decision is entirely yours.