Link Preview API
Get a link preview for up to 50 URLs per call: title, description, image, site name, favicon, type, language, canonical URL, author, published time, Twitter card, theme colour, oEmbed endpoint and JSON-LD types, read from the page's own Open Graph and meta tags. Image, PDF and video URLs get a preview from their headers. Private and internal addresses are refused. Monitor mode returns only URLs whose preview changed.
Example request
curl -X POST https://radarbg.com/v1/link-preview-open-graph \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"urls": ["https://example.com", "https://en.wikipedia.org/wiki/Bulgaria"], "onlyNew": false, "monitorId": "default"}'
Answer: {"ok": true, "count": N, "items": [...], "usage": {...}}. Failed calls are not counted.
Inputs
| Field | Type | Description |
|---|---|---|
urls | array | Web page, image, PDF or video URLs to preview, up to 50 per run (http or https; a URL without a scheme gets https). Each URL returns one row. Private, internal and localhost addresses are refused with an error row. |
onlyNew | boolean | Return a row only for URLs whose preview (title, description, image, canonical, type) is new or changed since the last run with this Monitor ID. The first run returns every URL. Errors are always returned. Use it on a schedule to watch page |
monitorId | string | Name of the watch list for Only changed previews mode, e.g. my-links. Each Monitor ID keeps its own memory. |
Price
Included in every plan: 100 calls a month free, then from €9 a month for 3,000 calls across all APIs.