Basic Example

API Request (GET):

http://api.linkpreview.net/?key=123456&q=https://www.google.com

API Response (JSON):

{
"title":"Google",
"description":"Search webpages, images, videos and more.",
"image":"https:\/\/www.google.com\/images\/logo.png",
"url":"https:\/\/www.google.com\/"
}

jQuery Ajax:

$.ajax({
    url: "https://api.linkpreview.net?key=123456&q=https://www.google.com",
    success: function(result){
        console.log(result);
    }
});


API Documentation

We've got what you need!


Preview links

I guess we all know what happens on Facebook when you paste an URL into a post?

Facebook's server automatically grabs the title, description, and picks a thumbnail image from the original website.

Our API service is doing this work for you!


Get Started
...

Easy to use

Our servers will inspect any requested URL and return JSON formatted summary with a title, description and preview image.

Bypassing same-origin policy is handled automatically. You can use either CORS or JSONP requests to bypass same-origin policy in your front-end application.


Documentation
...

Pricing


You can start with our Free Plan to see if this service can meet all your needs.

Free Plan


$ 0

Forever!

Personal Use
60 Requests / per hour
Unlimited API keys
SSL Requests
-
-

Get started

Basic Plan


$ 8

Per month

Personal Use
200 Requests / per hour
Unlimited API keys
SSL Requests
IP Whitelisting
Usage Analytics

Choose

Enterprise


$ 99

Per month

Commercial Use
5000 Requests / per hour
Unlimited API keys
SSL Requests
IP Whitelisting
Usage Analytics

Contact Us



Rate limits per requested domain may apply (max 1 request / per second / per domain)
All paid plans will be activated automatically after the purchase. You can cancel at any time.
Our payment processor Paddle accepts PayPal, Apple Pay, and all major Credit/Debit Cards, local taxes may apply.

...


WordPress Plugin

It’s very convenient to show link preview info on your WordPress site. Filip Stepanov created a WordPress plugin using our service.

Plugin operates in two different view modes - shortcode and Ajax tooltip on mouse over.



Download plugin

Frequently Asked Questions


Got a question? We've got answers. If you have some other questions, contact us using email.

Some sites return wrong or blank summary information?

Our service is based on well-known web page standards. Unfortunately, some webmasters do not follow best practices and therefore we cannot guarantee the correct response data for every URL.

For some URLs response time is way too long

Our API response time depends on external websites that we cannot control. Some sites are simply slow and we must wait for them to load in order to get and process the data.

Some websites like facebook are throwing "Forbidden by robots.txt" error

Some webistes like Facebook do not allow 3rd party services to access their site and collect data as you can see here. This is configured in their robots.txt file and that's why the error is thrown.

What if I don't want LinkPreview to crawl my site?

All you have to do is tell us using a robots.txt file. LinkPreview API identifies itself as “linkpreview” in the HTTP “User-agent” header field. Our service strictly adheres to robots.txt rules.

How the API rate is calculated?

The hourly counters for your API key reset on a rolling basis. Example for PRO Plan: If you made 500 requests at 10:15AM and 500 requests at 10:25AM, your API key would become temporarily blocked. This temporary block of your API key would cease at 11:15AM, at which point you could make 500 requests. At 11:25AM, you could then make another 500 requests.

Can I request refund?

Unfortunately, not. No refunds, partial or otherwise, will be issued for any used or unused portion of any billing cycle or late cancellations.