# Link Preview API Extract rich metadata, Open Graph tags, and images from any URL. Built to bypass blocks on social platforms and JavaScript-heavy sites. [![RapidAPI](https://img.shields.io/badge/RapidAPI-Subscribe-green)](https://rapidapi.com/zapapi-zapapi-default/api/link-previewer-api) [![Version](https://img.shields.io/badge/version-1.2.0-blue)]() ## 🚀 Quick Start ### 1. Subscribe Get your API key from [RapidAPI](https://rapidapi.com/zapapi-zapapi-default/api/link-previewer-api). Choose a plan that fits your needs. ### 2. Make Your First Request **cURL** ```bash curl --request GET \ --url 'https://link-previewer-api.p.rapidapi.com/preview?q=https%3A%2F%2Fgithub.com' \ --header 'x-rapidapi-key: YOUR_API_KEY' \ --header 'x-rapidapi-host: link-previewer-api.p.rapidapi.com' ``` **JavaScript (Fetch)** ```javascript const url = 'https://link-previewer-api.p.rapidapi.com/preview'; const params = new URLSearchParams({ q: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ' }); fetch(`${url}?${params}`, { method: 'GET', headers: { 'X-RapidAPI-Key': 'YOUR_API_KEY', 'X-RapidAPI-Host': 'link-previewer-api.p.rapidapi.com' } }) .then(response => response.json()) .then(data => { console.log(data.title); // "Rick Astley - Never Gonna Give You Up..." console.log(data.image); // Thumbnail URL }) .catch(err => console.error(err)); ``` **Python (Requests)** ```python import requests url = "https://link-previewer-api.p.rapidapi.com/preview" querystring = {"q":"https://www.reddit.com"} headers = { "X-RapidAPI-Key": "YOUR_API_KEY", "X-RapidAPI-Host": "link-previewer-api.p.rapidapi.com" } response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` **PHP** ```php <?php $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://link-previewer-api.p.rapidapi.com/preview?q=https%3A%2F%2Fwww.producthunt.com", CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "X-RapidAPI-Key: YOUR_API_KEY", "X-RapidAPI-Host: link-previewer-api.p.rapidapi.com" ], ]); $response = curl_exec($curl); curl_close($curl); $data = json_decode($response, true); echo $data['title']; ?> ``` ## 📋 Response Schema ```json { "title": "YouTube", "description": "Disfruta los videos y la música que te encantan...", "url": "https://www.youtube.com/", "image": "https://www.youtube.com/img/desktop/yt_1200.png", "domain": "youtube.com", "charset": "utf-8" } ``` ## ⚠️ Error Handling **Common HTTP Status Codes:** - `200` - Success with metadata - `400` - Invalid URL format - `404` - Target page not found - `429` - Rate limit exceeded (check pricing page for limits) - `500` - Server error or target timeout ## 💡 Use Cases ### React Component ```jsx import { useState, useEffect } from 'react'; function LinkPreview({ url }) { const [preview, setPreview] = useState(null); useEffect(() => { fetch(`https://link-previewer-api.p.rapidapi.com/preview?q=${encodeURIComponent(url)}`, { headers: { 'X-RapidAPI-Key': process.env.REACT_APP_RAPIDAPI_KEY } }) .then(res => res.json()) .then(data => setPreview(data)); }, [url]); if (!preview) return

; return (

{preview.title}

{preview.description}

{preview.domain} ); } ``` ### Node.js/Express Middleware ```javascript const express = require('express'); const axios = require('axios'); const app = express(); app.get('/api/preview', async (req, res) => { try { const { url } = req.query; if (!url) return res.status(400).json({ error: 'URL required' }); const response = await axios.get('https://link-previewer-api.p.rapidapi.com/preview', { params: { q: url }, headers: { 'X-RapidAPI-Key': process.env.RAPIDAPI_KEY, 'X-RapidAPI-Host': 'link-previewer-api.p.rapidapi.com' } }); res.json(response.data); } catch (error) { res.status(500).json({ error: 'Failed to fetch preview' }); } }); ``` ## 🔧 Configuration Options Query Parameters: | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `q` | string | Yes | Target URL to preview (must be URL-encoded) | **Example endpoint:** https://link-previewer-api.p.rapidapi.com/preview?q=https%3A%2F%2Fwww.youtube.com ## 🐛 Troubleshooting **Getting 429 errors?** You've hit the rate limit. Check your usage on the [RapidAPI dashboard](https://rapidapi.com/developer/dashboard) or upgrade your plan on the [pricing page](https://rapidapi.com/zapapi-zapapi-default/api/link-previewer-api/pricing). **Images returning null?** Some sites block image extraction. We return available metadata even if images are blocked. **Encoding issues?** Always URL-encode the target URL: ```javascript // Correct const params = new URLSearchParams({ q: 'https://example.com' }); // Incorrect (will fail on URLs with query params) const url = `?q=${targetUrl}`;