Data Models¶

InstaHarvest v2 uses Pydantic models for structured, validated data.

Available Models¶

Model	Description
`User`	Full user profile
`UserShort`	Minimal user info (pk, username)
`Media`	Post/reel/IGTV data
`Caption`	Media caption
`Comment`	Post comment
`Story`	Story item
`StorySticker`	Story sticker data
`Highlight`	Story highlight
`DirectThread`	DM thread
`DirectMessage`	Single DM message
`Location`	Location data
`Notification`	Notification item

User Model¶

from instaharvest_v2.models import User

user = ig.users.get_by_username("cristiano")

Field	Type	Description
`pk`	`int`	Unique user ID
`username`	`str`	Username
`full_name`	`str`	Display name
`biography`	`str`	Bio text
`bio_links`	`list`	Links in bio
`profile_pic_url`	`str`	Profile picture URL
`profile_pic_url_hd`	`str`	HD profile picture
`followers`	`int`	Follower count
`following`	`int`	Following count
`posts_count`	`int`	Total posts
`is_private`	`bool`	Private account
`is_verified`	`bool`	Verified badge
`is_business`	`bool`	Business account
`category`	`str`	Business category
`external_url`	`str`	Website URL
`contact`	`Contact`	Phone/email (business)

Media Model¶

from instaharvest_v2.models import Media

media = ig.media.get_by_shortcode("ABC123")

Field	Type	Description
`pk`	`int`	Media ID
`shortcode`	`str`	URL shortcode
`media_type`	`int`	1=photo, 2=video, 8=carousel
`caption`	`Caption`	Caption object
`like_count`	`int`	Number of likes
`comment_count`	`int`	Number of comments
`taken_at`	`datetime`	Post timestamp
`image_versions`	`list`	Image URLs + sizes
`video_url`	`str`	Video URL (if video)
`video_duration`	`float`	Duration in seconds
`video_view_count`	`int`	View count
`carousel_media`	`list`	Child media items
`location`	`Location`	Tagged location
`usertags`	`list`	Tagged users

Dict-Like Access¶

All models support dict-like access for backward compatibility:

user = ig.users.get_by_username("nike")

# Attribute access (recommended)
print(user.username)
print(user.followers)

# Dict-like access (backward compat)
print(user["username"])
print(user.get("followers", 0))

# Convert to dict
data = user.to_dict()

Import¶

from instaharvest_v2.models import (
    User, UserShort, Contact, BioParsed,
    Media, Caption,
    Comment,
    Story, StorySticker, Highlight,
    DirectThread, DirectMessage,
    Location,
    Notification,
)