Get link (URL) preview
Project description
linkpreview
Get link preview in python
Gathering data from:
- OpenGraph meta tags
- TwitterCard meta tags
- Microdata meta tags
- JSON-LD meta tags
- HTML Generic tags (
h1,p,img) - URL readable parts
Install
pip install linkpreview
Usage
Basic:
from linkpreview import link_preview
url = "http://localhost"
content = """
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width">
<!-- ... --->
<title>a title</title>
</head>
<body>
<!-- ... --->
</body>
</html>
"""
preview = link_preview(url, content)
print("title:", preview.title)
print("description:", preview.description)
print("image:", preview.image)
print("force_title:", preview.force_title)
print("absolute_image:", preview.absolute_image)
print("site_name:", preview.site_name)
Automatic fetch link content
from linkpreview import link_preview
preview = link_preview("http://github.com/")
print("title:", preview.title)
print("description:", preview.description)
print("image:", preview.image)
print("force_title:", preview.force_title)
print("absolute_image:", preview.absolute_image)
print("site_name:", preview.site_name)
Use lxml as XML parser:
Very recommended for better performance
from linkpreview import link_preview
preview = link_preview("http://github.com/", parser="lxml")
print("title:", preview.title)
print("description:", preview.description)
print("image:", preview.image)
print("force_title:", preview.force_title)
print("absolute_image:", preview.absolute_image)
print("site_name:", preview.site_name)
Advanced
from linkpreview import Link, LinkPreview, LinkGrabber
url = "http://github.com"
grabber = LinkGrabber(
initial_timeout=20,
maxsize=1048576,
receive_timeout=10,
chunk_size=1024,
)
content, url = grabber.get_content(url)
link = Link(url, content)
preview = LinkPreview(link, parser="lxml")
print("title:", preview.title)
print("description:", preview.description)
print("image:", preview.image)
print("force_title:", preview.force_title)
print("absolute_image:", preview.absolute_image)
print("site_name:", preview.site_name)
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
linkpreview-0.5.0.tar.gz
(8.7 kB
view details)
Built Distribution
File details
Details for the file linkpreview-0.5.0.tar.gz.
File metadata
- Download URL: linkpreview-0.5.0.tar.gz
- Upload date:
- Size: 8.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 57b31c8d7375970770a3b84959e3e3a10ec5b46b4b264c377cdbb0a2c0a1280f |
|
| MD5 | 388ee46d69373080808e1cf4b308c3a1 |
|
| BLAKE2b-256 | ea36a7c8fd386b7ec7bc57e95caa2538cbd33a0c9e41e76cbb4cd7a93fd03de3 |
File details
Details for the file linkpreview-0.5.0-py3-none-any.whl.
File metadata
- Download URL: linkpreview-0.5.0-py3-none-any.whl
- Upload date:
- Size: 11.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 60987085ba55a8dd1e1a66165944d907ab084ee21a3e3e6853c5f8b2af9bf770 |
|
| MD5 | 87ce86132109e18964a365c57bc2a7e1 |
|
| BLAKE2b-256 | 08ac08527125b81639dc9753ce93238498cbd9a0d0b41acc2050e55a4f3455cb |
