subzeroid/instagrapi
Instagrapi
Features
- Social Media Automation - Automates Instagram user, media, story, messaging, upload, and insight operations through a unified API wrapper.
- API Wrappers - An unofficial Python library that wraps Instagram's private and public APIs for automated content retrieval and social media management.
- Social Media Account Workload Separations - Separates read and write workloads across accounts to reduce the risk of platform restrictions.
- Detailed Follower Profile Exporters - Returns detailed profile fields per follower including username, profile picture, verification status, and business contact info.
- Gradual Account Warmups - Gradually warms new accounts with read-heavy actions to avoid triggering anti-abuse systems.
- Intersection Analyzers - Computes follower intersection sets between Instagram accounts to reveal shared audiences.
- Public Account Follower Retrievers - Retrieves the complete follower list of any public Instagram account through paginated API requests.
- Public Account Following Retrievers - Retrieves the complete list of accounts a public Instagram user follows, supporting pagination for large datasets.
- Follower List Retrievers - Returns complete paginated follower and following lists for any public Instagram user without OAuth.
- Social Media Content Management - Uploads and manages Instagram media, stories, and reels programmatically with metadata and engagement tracking.
- Social Media Data Scraping - Scrapes public Instagram data including profiles, posts, comments, and followers without OAuth.
- Profile Information Retrieval - Gets public user data such as username, full name, and profile picture from the platform.
- Client Environment Emulations - Configures proxies, device profile, user agent, locale, and timezone to mimic a stable client environment.
- User Profile Retrieval - Retrieves full Instagram profile data including bio, follower count, and business contact info via API key.
- Story Content Retrieval - Returns current stories and highlight reels with direct media URLs and metadata before they expire.
- High Performance Scraping - Scales high-volume scraping by processing large batches of profile or media requests without throttling.
- Social Media Automation Clients - Automates Instagram actions like login, session management, posting, messaging, and follower analysis through a unified interface.
- Interactive Challenge Resolvers - Automatically resolves Instagram security challenges during the authentication flow.
- Automated Credential Logins - Automates credential-based login with optional TOTP two-factor authentication for secure access.
- HTTP Session Persisters - Saves and reloads HTTP session state and cookies from local files to maintain continuity across runs.
- Rate Limiting & Abuse Prevention - Distinguishes between throttling, session expiry, and challenges, applying different recovery actions for each.
- Randomized Request Delays - Inserts variable pauses between requests to mimic human browsing patterns and avoid detection.
- Session Authentication - Manages Instagram login sessions, handles 2FA, challenges, and cookie persistence for automated access.
- Session-Cookie Persistences - Persists session cookies and device identifiers to avoid repeated password logins across runs.
- Session Management - Stores, loads, and saves session cookies and device configuration to a file for reuse.
- Rate-Limit-Aware Backoffs - Ships a rate-limit-aware backoff that distinguishes throttling, session expiry, and challenge responses.
- Social Graph Paginators - Paginates through Instagram API responses to retrieve complete follower, following, comment, and media lists.
- Authenticated Session Clients - Sends requests through Instagram's private mobile API using a logged-in session for authorized operations.
- Public-Fallback API Routings - Implements a fallback routing strategy that tries public endpoints before authenticated mobile API paths.
- Social Media Extraction Tools - Extracts public Instagram data including profiles, posts, reels, stories, and engagement metrics without OAuth.
- Account-Level Read-Write Separations - Separates read and write workloads across accounts to reduce the risk of restrictions on social media platforms.
- Message Management - Reads and sends messages within private conversation threads on the platform.
- Model Context Protocol Servers - An MCP server that exposes Instagram and Threads data tools for natural-language queries from AI assistants.
- Social Media Post Retrievers - Accesses public post metadata, reels, and their associated comments from Instagram.
- Reel Downloaders - Fetches a specific reel by its shortcode or media ID and provides a direct HD video download URL.
- Engagement Data Scrapers - Collects comments, follower lists, and like/comment counts on posts with pagination support.
- Media Post Scrapers - Fetches posts, reels, and stories with captions, engagement metrics, and download URLs for any media type.
- Comment Extractors - Paginates through all comments on a post with commenter profiles and timestamps for analysis.
- Social Platform Data Extraction - Fetches public Threads profile metadata, posts, replies, and network relationships for analytics and monitoring.
- Engagement Metadata Extraction - Returns view, play, like, and comment counts for a reel to measure its performance.
- Social Media Location Scrapers - Returns top and recent posts along with metadata for a given hashtag or geographic location.
- Hashtag Data Queries - Returns hashtag metadata, post counts, top and recent posts, and related hashtags for any tag.
- Social Media Location Finders - Finds locations by name and retrieves top and recent posts along with address and coordinates.
- Social Media Account Insights - Provides analytics data for individual Instagram posts including engagement metrics.
- Social Media Content Searches - Queries users, hashtags, and places in a single request and returns ranked results matching any keyword.
- Social Media Filtered Searches - Queries public Instagram content filtered by hashtag or location identifiers.
- Hashtag Post Retrievers - Returns top and recent posts associated with a given hashtag.
- Social Media Entity Discoverers - Discovers users, places, and hashtags through Instagram's search endpoints.
- Threads Data Extractors - Fetches Threads user profiles, posts, replies, and network relationships for analytics and monitoring.
- AI Assistant Integrations - Exposes Instagram data tools over the Model Context Protocol for AI assistant consumption.
- Social Media Content Retrievers - Fetches full publication data including photos, videos, albums, IGTV, and Reels from the platform.
- Interactive Story Posting - Adds stickers, location tags, user mentions, and hashtags to ephemeral story posts.
- Reel Metadata Accessors - Fetches video metadata, play counts, and audio information for Instagram Reels.
- Unresolvable Challenge Handlers - Raises exceptions for selfie or manual-review challenges that require resolution in the official app.
- Code Verifications - Automatically processes verification codes received via email or SMS by calling a custom handler.
- Cookie-Based Authentication Bridges - Authenticates using a sessionid cookie for lightweight compatibility with existing browser sessions.
- Platform-Specific Two-Factor Flows - Automatically detects and retries login through Instagram's Bloks two-factor verification when legacy endpoints fail.
- User Reel Retrievers - Retrieves all reels published by a specific user, returning metadata and download links for each video.
- Threads Content Collectors - Collects and processes public Threads content programmatically for trend and engagement tracking.
- Social Media Monitoring - Polls accounts for new media or stories using a saved session and compares against stored state.
