Documentation Index
Fetch the complete documentation index at: https://mintlify.com/karilaa-dev/tt-bot/llms.txt
Use this file to discover all available pages before exploring further.
Represents a single media item from an Instagram post.
Fields
The media type: "video" or "image"
Direct URL to the media file
Thumbnail image URL (if available)
Quality indicator for the media (if provided by API)
Example
from instagram_api.models import InstagramMediaItem
item = InstagramMediaItem(
type="video",
url="https://example.com/video.mp4",
thumbnail="https://example.com/thumb.jpg",
quality="hd"
)
print(item.type) # "video"
print(item.url) # "https://example.com/video.mp4"
Fields
media
list[InstagramMediaItem]
default:"[]"
List of media items in the post. Single item for regular posts/videos, multiple items for carousel posts.
The original Instagram URL for the post
Properties
is_video
Returns True if the post contains a single video item.
@property
def is_video(self) -> bool
True when the post has exactly one media item of type "video"
is_carousel
Returns True if the post contains multiple media items (carousel/album).
@property
def is_carousel(self) -> bool
True when the post has more than one media item
image_urls
Returns a list of URLs for all image items in the post.
@property
def image_urls(self) -> list[str]
List of direct URLs to all images in the post (excludes videos)
video_url
Returns the URL of the first video found in the post.
@property
def video_url(self) -> str | None
URL of the first video item, or None if no videos are present
thumbnail_url
Returns the first available thumbnail URL from any media item.
@property
def thumbnail_url(self) -> str | None
The first thumbnail URL found, or None if no thumbnails are available
Example Usage
from instagram_api.models import InstagramMediaInfo, InstagramMediaItem
# Single video post
video_post = InstagramMediaInfo(
media=[
InstagramMediaItem(
type="video",
url="https://example.com/video.mp4",
thumbnail="https://example.com/thumb.jpg"
)
],
link="https://instagram.com/p/ABC123/"
)
print(video_post.is_video) # True
print(video_post.is_carousel) # False
print(video_post.video_url) # "https://example.com/video.mp4"
print(video_post.thumbnail_url) # "https://example.com/thumb.jpg"
# Carousel post with mixed media
carousel_post = InstagramMediaInfo(
media=[
InstagramMediaItem(type="image", url="https://example.com/img1.jpg"),
InstagramMediaItem(type="video", url="https://example.com/vid.mp4"),
InstagramMediaItem(type="image", url="https://example.com/img2.jpg")
],
link="https://instagram.com/p/XYZ789/"
)
print(carousel_post.is_carousel) # True
print(len(carousel_post.media)) # 3
print(carousel_post.image_urls) # ["https://example.com/img1.jpg", "https://example.com/img2.jpg"]
print(carousel_post.video_url) # "https://example.com/vid.mp4"
