IG Follower Export

Purpose and user intent: This tool provides a reproducible, exportable snapshot of an Instagram account's followers for analytics, audience segmentation, and compliance auditing. It targets marketers, content creators, social media teams, and researchers who need a portable dataset to inform outreach, creative planning, or performance reporting. The tool is designed for accounts with authorized API access or consent-based data retrieval. Output includes follower username, full name, profile URL, bio snippet, external website, account privacy status, follower/following/media counts, and a timestamp. It supports data-driven campaigns, quarterly audits, and historical trend analysis. The resulting dataset enables reproducible reporting and benchmark comparisons while preserving data lineage. The system aims to minimize manual data wrangling and to integrate into existing analytics pipelines. Core Logic & Features: Required inputs include profile identifier (username or URL) and export format; optional inputs include date range, fields to include, and API access token. Advanced features add pagination handling, rate-limit management, deduplication, data validation, and field normalization. Outputs can be CSV or JSON by default, with optional Google Sheets export via connected account. Optional metadata such as export_timestamp and source_profile can be included. Core rules ensure privacy constraints, skip private or inaccessible profiles, and log skipped items for traceability. The system enforces deterministic field schemas and consistent timestamping to support automation pipelines. Optional preprocessing enables field normalization (e.g., trimming whitespace, standardizing case) to improve downstream analytics. Inputs & Outputs: Inputs: profile_id (string), profile_url (string, optional), export_format (enum: CSV/JSON), include_private_data (boolean, optional), date_range (start_date, end_date, optional), api_token (string, optional). Outputs: dataset with fields: username, full_name, profile_url, bio, website, is_private (boolean), follower_count (integer), following_count (integer), media_count (integer), export_timestamp (iso8601), source_profile (string). Output formats: CSV with headers, JSON array, or Google Sheets feed if configured. Validation: required fields non-empty; numeric fields non-negative; dates valid ISO 8601. Algorithms & Calculations: The tool uses a paginated API call to retrieve followers; it iterates pages until exhausted, collecting records into a structured dataset; deduplication by username; only basic counts are computed from API data unless explicitly requested for derived statistics. No predictive analytics are performed unless added as an optional module. Error & Edge Cases: Handles invalid profile identifiers, private or restricted accounts, and API rate limits with retry logic and exponential backoff. Logs include skipped records and reasons; falls back to partial data if some pages fail; network outages trigger retry up to configured limits and may produce a partial export. Industry/Region & Localization: Assumes global Instagram usage; timestamps use ISO 8601; UTC default with optional time-zone configuration; outputs support locale-aware formatting for dates and numbers if enabled. Assumptions & Exclusions: Assumes approved API access or explicit user consent; excludes scraping private data without permission; not a live follower-activity tracker or engagement analyzer; not a social graph reconstruction beyond the follower list and basic metadata; not a marketing automation engine.