Get a link preview
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The language of the user
Body
Request to generate a link preview
Only available to enterprise customers working on integrations. Every link is guaranteed fresh, this is just for debugging timing issues.
true, false Only available to enterprise customers working on integrations. Every link is guaranteed fresh, this is just for debugging timing issues.
true, false Source of the link preview request
API, WEB Response
Complete information about a link and its associated content
Domain name from the URL
Unique identifier for the link
Whether the link is valid
Whether the URL was redirected
HTTP status code
Type of content the link represents
UNKNOWN, IMAGE, VIDEO, AUDIO, DOCUMENT, TEXT, PAGE, YOUTUBE_USER, X_USER, X_POST, INSTAGRAM_USER, INSTAGRAM_POST, YOUTUBE_VIDEO, AMAZON_PRODUCT, ETSY_PRODUCT, REDDIT_USER, REDDIT_POST, REDDIT_SUBREDDIT, TIKTOK_USER, TIKTOK_VIDEO, GITHUB_REPOSITORY Last update timestamp
Original URL
Information about an Amazon product
Amazon product identifier
Price currency code
Product description
Image format (e.g., JPEG, PNG)
Whether the image has transparency
Height of the image in pixels
Size of the image file in bytes
Width of the image in pixels
Dominant background color in hex format
Dark muted color in hex format
Dark vibrant color in hex format
Light muted color in hex format
Light vibrant color in hex format
Muted color in hex format
Most vibrant color in hex format
Product price
Product rating
Number of reviews
Product title
Detailed information about an audio file
Codec used for audio encoding
Bitrate of the audio in bits per second
Creation date of the audio file
Duration of the audio in seconds
Size of the audio file in bytes
Album name if part of one
Collection of differently sized versions of an image
Artist/creator of the audio
Number of audio channels
Audio format/container type
Sample rate in Hz
Title of the audio track
Page description (only missing when ok: false)
Detailed information about a document
Whether the document is encrypted
Total number of pages
Title of the document
Author of the document
Description or summary of the document
Estimated reading time in minutes
Collection of differently sized versions of an image
Document language code
Last modification date
Page number in the document
Collection of differently sized versions of an image
URL to access the raw text content
Document type/format
Information about an Etsy product
Etsy product identifier
Price currency code
Product description
Image format (e.g., JPEG, PNG)
Whether the image has transparency
Height of the image in pixels
Size of the image file in bytes
Width of the image in pixels
Dominant background color in hex format
Dark muted color in hex format
Dark vibrant color in hex format
Light muted color in hex format
Light vibrant color in hex format
Muted color in hex format
Most vibrant color in hex format
Product price
Product rating
Number of reviews
Product title
Detailed information about a GitHub repository
Unique identifier for the repository
Repository name
Number of commits
Number of contributors
Repository description
Number of forks
Number of open issues
Date of last commit
Number of open pull requests
Number of stars
Number of watchers
Collection of differently sized versions of an image
Information about an Instagram post
Unique identifier for the Instagram post
Post publication date
Number of comments
Number of likes
Image format (e.g., JPEG, PNG)
Whether the image has transparency
Height of the image in pixels
Size of the image file in bytes
Width of the image in pixels
Dominant background color in hex format
Dark muted color in hex format
Dark vibrant color in hex format
Light muted color in hex format
Light vibrant color in hex format
Muted color in hex format
Most vibrant color in hex format
Post caption
Information about an Instagram user
Unique identifier for the Instagram user
Instagram username
Whether the account is verified
Collection of differently sized versions of an image
User biography
Number of followers
Number of accounts following
Display name
Number of posts
Website URL
Account visibility
PUBLIC, PRIVATE Information about an Instagram user
Unique identifier for the Instagram user
Instagram username
Whether the account is verified
Collection of differently sized versions of an image
User biography
Number of followers
Number of accounts following
Display name
Number of posts
Website URL
Account visibility
PUBLIC, PRIVATE Content language code
Information about a web page
Estimated reading time in minutes
URL to access the HTML version
URL to access the Markdown version
URL to access the raw text content
Collection of differently sized versions of an image
Information about a Reddit post
Post creation date
Unique identifier for the Reddit post
Post last update date
External identifier for the post
Number of comments
Number of upvotes
Duration of the video in seconds
Frame rate of the video in frames per second
Whether the video has an audio track
Size of the video file in bytes
Codec used for video encoding
Author/creator of the video
Bitrate of the video in bits per second
Video format/container type
Height of the video in pixels
Collection of differently sized versions of an image
Name of the video file
Collection of differently sized versions of an image
Information about an image asset
Information about an image asset
Information about an image asset
Information about an image asset
Timestamp of the snapshot in seconds
Title of the video
Video assets with different sizes
Width of the video in pixels
Post publication date
Information about a Reddit subreddit
Unique identifier for the subreddit
Subreddit name
Number of active users
Collection of differently sized versions of an image
Collection of differently sized versions of an image
Subreddit creation date
Subreddit description
Whether the subreddit is NSFW
Number of subscribers
Subreddit title
Subreddit type
Post content
Type of Reddit post
IMAGE, GALLERY, VIDEO, LINK, TEXT, POLL, CROSSPOST, LIVE Information about a Reddit user
Unique identifier for the Reddit user
Reddit username
Collection of differently sized versions of an image
Collection of differently sized versions of an image
Information about an image asset
Collection of differently sized versions of an image
User biography
Comment karma points
Collection of differently sized versions of an image
Account creation date
Total karma points
Display name
Post karma points
Information about a Reddit subreddit
Unique identifier for the subreddit
Subreddit name
Number of active users
Collection of differently sized versions of an image
Collection of differently sized versions of an image
Subreddit creation date
Subreddit description
Whether the subreddit is NSFW
Number of subscribers
Subreddit title
Subreddit type
Information about a Reddit user
Unique identifier for the Reddit user
Reddit username
Collection of differently sized versions of an image
Collection of differently sized versions of an image
Collection of differently sized versions of an image
User biography
Comment karma points
Collection of differently sized versions of an image
Account creation date
Total karma points
Display name
Post karma points
Number of redirects
Final URL after redirects
Optional identifier for tracking the request
Content size in bytes
Information about plain text content
Estimated reading time in minutes
Collection of differently sized versions of an image
URL to access the raw text content
Size of the text content in bytes
Information about a TikTok user
Unique identifier for the TikTok user
TikTok username
Whether the account is verified
Collection of differently sized versions of an image
User biography
Number of followers
Number of accounts following
Number of likes received
Display name
Profile URL
Account visibility
PUBLIC, PRIVATE Information about a TikTok video
Unique identifier for the TikTok video
Number of comments
Number of likes
Image format (e.g., JPEG, PNG)
Whether the image has transparency
Height of the image in pixels
Size of the image file in bytes
Width of the image in pixels
Dominant background color in hex format
Dark muted color in hex format
Dark vibrant color in hex format
Light muted color in hex format
Light vibrant color in hex format
Muted color in hex format
Most vibrant color in hex format
Number of plays
Video publication date
Number of shares
Video caption
Information about a TikTok user
Unique identifier for the TikTok user
TikTok username
Whether the account is verified
Collection of differently sized versions of an image
User biography
Number of followers
Number of accounts following
Number of likes received
Display name
Profile URL
Account visibility
PUBLIC, PRIVATE Page title (only missing when ok: false)
Detailed information about a video file
Duration of the video in seconds
Frame rate of the video in frames per second
Whether the video has an audio track
Size of the video file in bytes
Codec used for video encoding
Author/creator of the video
Bitrate of the video in bits per second
Video format/container type
Height of the video in pixels
Collection of differently sized versions of an image
Name of the video file
Collection of differently sized versions of an image
Timestamp of the snapshot in seconds
Title of the video
Width of the video in pixels
Information about an X (formerly Twitter) post
Unique identifier for the X post
Number of bookmarks
Number of comments
Post creation date
Number of likes
Duration of the video in seconds
Frame rate of the video in frames per second
Whether the video has an audio track
Size of the video file in bytes
Codec used for video encoding
Author/creator of the video
Bitrate of the video in bits per second
Video format/container type
Height of the video in pixels
Collection of differently sized versions of an image
Name of the video file
Collection of differently sized versions of an image
Information about an image asset
Information about an image asset
Information about an image asset
Information about an image asset
Timestamp of the snapshot in seconds
Title of the video
Width of the video in pixels
Post publication date
Number of quote posts
Number of reposts
Post content
Post last update date
Information about an X (formerly Twitter) user
Unique identifier for the X user
Collection of differently sized versions of an image
User biography
Collection of differently sized versions of an image
Number of followers
Number of accounts following
Account creation date
User location
Display name
Number of posts
Whether the account is protected
Whether the account contains sensitive content
Website URL
X username
Whether the user is verified
Number of views
Information about an X (formerly Twitter) user
Unique identifier for the X user
Collection of differently sized versions of an image
User biography
Collection of differently sized versions of an image
Number of followers
Number of accounts following
Account creation date
User location
Display name
Number of posts
Whether the account is protected
Whether the account contains sensitive content
Website URL
X username
Whether the user is verified
Information about a YouTube channel
Unique identifier for the YouTube user
YouTube username
Collection of differently sized versions of an image
Collection of differently sized versions of an image
Channel description
External YouTube channel ID
Whether content is family-safe
Channel creation date
Display name
Number of subscribers
Channel URL
Whether channel is verified
Number of uploaded videos
Total channel views
Visibility status of the content
PUBLIC, PRIVATE Information about a YouTube video
Unique identifier for the video
YouTube video ID
Number of comments
Video description
Number of dislikes
Video duration in seconds
Number of likes
Publication date
Video rating
Collection of differently sized versions of an image
Video title
Information about a YouTube channel
Unique identifier for the YouTube user
YouTube username
Collection of differently sized versions of an image
Collection of differently sized versions of an image
Channel description
External YouTube channel ID
Whether content is family-safe
Channel creation date
Display name
Number of subscribers
Channel URL
Whether channel is verified
Number of uploaded videos
Total channel views
Visibility status of the content
PUBLIC, PRIVATE Number of views