About LinkPreview API
What is LinkPreview?
LinkPreview is a powerful API service designed to generate rich link previews for any given URL. It provides users with a snippet of the web page's content, including the title, description, and thumbnail image, similar to the link previews seen on social media platforms like Facebook and Twitter. This tool is invaluable for developers and content creators who want to enhance the user experience by providing informative previews of links shared within their applications.
How LinkPreview Works
LinkPreview operates by inspecting the provided URL and extracting relevant metadata to create a preview. Users can make API calls to https://api.linkpreview.net with their unique API key and the desired URL. The API responds with a JSON object containing the title, description, image URL, and other metadata about the web page. This process can be easily integrated into websites, mobile apps, or any other platform that requires dynamic link previews.
What Problem LinkPreview Solves
LinkPreview addresses the need for dynamic and informative link previews in applications. Manually creating these previews can be time-consuming and inconsistent. LinkPreview automates this process, ensuring that users always see a clear and accurate representation of the linked content. This is particularly useful for social media platforms, messaging apps, and any application where users frequently share links.
LinkPreview Features
Title Extraction
Automatically grabs the title of the webpage for the preview.
Description Extraction
Provides a brief description of the content on the webpage.
Thumbnail Image
Includes a thumbnail image from the webpage to enhance the preview.
JSON Response
Returns all data in a structured JSON format, easy for developers to use.
Multi-Format Support
Supports JSONP and CORS for handling cross-origin requests.
High Request Limits
Different pricing tiers allow for a high number of API requests per hour.
Custom Integrations
Works with numerous popular websites and content providers for accurate previews.
Pricing
LinkPreview offers several pricing plans to accommodate different needs:
- Free Plan: Includes 60 requests per hour, suitable for personal use.
- Basic Plan: $8 per month, includes 200 requests per hour and usage analytics.
- Pro Plan: $25 per month, includes 1000 requests per hour, image processing, and usage analytics.
- Enterprise Plan: $199 per month, includes 100 requests per minute, unlimited requests, and advanced features like CDN integration and on-premise hosting options.
Pros and Cons
Pros:
- Easy integration with a simple API.
- Free plan available for basic needs.
- High accuracy and reliability in extracting metadata.
- Supports JSONP and CORS for cross-origin requests.
- Comprehensive documentation and support.
Cons:
- Free plan has limited features and request limits.
- Advanced features and higher request limits require a subscription.
Common Questions
How do I get started with LinkPreview?
Sign up for a free account on their website to get an API key. Use this key to make API calls to https://api.linkpreview.net.
What data does the LinkPreview API return?
The API returns a JSON object containing the title, description, image URL, and favicon of the webpage.
Is there a free version of LinkPreview?
Yes, there is a free plan that includes 60 requests per hour.
Can I use LinkPreview for commercial purposes?
Yes, but you will need to subscribe to one of the paid plans that support commercial use.
Conclusion
LinkPreview is an essential tool for developers and content creators who need to generate dynamic and informative link previews. With its easy integration, multiple pricing plans, and high accuracy, it offers a robust solution for enhancing the user experience on any platform. Whether you are building a social media app, a messaging service, or a content-rich website, LinkPreview provides the tools you need to make your links stand out.
LinkPreview API Pros & Cons
- Free plan available for testing the API
- Operational since 2014, serving millions of requests daily
- Direct integrations for major content providers
- Usage analytics and image processing on paid plans
- Some sites return blank or incorrect previews if they lack standard metadata
- Free and Basic plans are restricted to personal use
- Per-domain rate limit caps requests at 1 per second per unique domain
Key Features
JSON API responses
Returns the target page's title, description, image, and URL in a single JSON response.
Provider integrations
Maintains direct integrations for Amazon, YouTube, X, Wikipedia, Airbnb, The New York Times, The Guardian, SoundCloud, TED, Vimeo, and Giphy.
Open Graph support
Follows Open Graph and common web page standards to build previews from page metadata.
Image processing
Pro+Processes preview images on the Pro and Enterprise plans.
Usage analytics
Basic+Provides usage analytics on the Basic, Pro, and Enterprise plans.
Additional fields
Basic+Adds additional metadata fields on paid plans.
LinkPreview API Pricing
View full pricing →- 60 requests per hour
- Personal use only
- 200 requests per hour
- Additional fields
- Usage analytics
- Personal use only
- 1000 requests per hour
- Additional fields
- Image processing
- Usage analytics
- Commercial use
- 100 requests per minute
- Additional fields
- Image processing
- Usage analytics
- Commercial use
- Contact sales for more requests
| Feature | Free Free/mo | Basic $8/mo | Pro $25/mo | Enterprise $119/mo |
|---|---|---|---|---|
| Image processing | ||||
| Usage analytics | ||||
| Additional fields |
Pricing extracted from the product website and may change. Check the source for current details.
Frequently asked questions about LinkPreview API
Why do some sites return a blank or incorrect summary?
The API follows common web page standards. Some sites do not follow those standards, so complete data cannot be guaranteed for every URL.
Can I cancel at any time?
Yes. You can cancel at any time. Sign in, open your Profile, and cancel from there.
Why are some URLs slow to respond?
Response time depends on the target website. If that site is slow to load, the API has to wait before it can return a preview.
How is the rate limit calculated?
Hourly counters for your API key reset on a rolling basis. For example, on the Pro Plan, if you make 500 requests at 10:15 AM and 500 more at 10:25 AM, your key is temporarily blocked until 11:15 AM.
Why do I get a 423 'Forbidden by robots.txt' error?
Some websites do not allow third-party services to fetch their pages. That is configured in their robots.txt file, which is why this error is returned.
Why am I getting a 4xx error?
See the error reference in the documentation for each status code and what it means.