Skip to content

121yaseen/insta-scrapper

Repository files navigation

🔍 InstaScrapr

InstaScrapr Banner

Powerful Instagram analytics and insights for creators, marketers, and businesses

License: MIT Next.js Tailwind CSS TypeScript Clerk Prisma

FeaturesTech StackGetting StartedContributingRoadmapLicense

🚀 Overview

InstaScrapr is an open-source Instagram analytics platform that provides comprehensive insights into any Instagram profile without requiring login credentials. It helps marketers, creators, and businesses track performance metrics, analyze engagement, and understand audience demographics.

📸 Screenshots

Dashboard Overview Dashboard

Profile Analysis Profile Analysis

Historical Data Historical Data

✨ Features

  • 💯 Profile Analysis: Retrieve metrics for any public Instagram handle
  • 📊 Comprehensive Analytics: Analyze followers, engagement rates, and content performance
  • 📱 Post & Reel Insights: Extract data from individual posts and reels
  • 📅 Historical Tracking: Monitor changes and trends over time
  • 📋 Data Export: Download reports in various formats for your presentations
  • 🔍 Creator Discovery: Find influencers by location, language, and niche

🛠️ Tech Stack

🏁 Getting Started

Prerequisites

  • Node.js 18.x or later
  • PostgreSQL database
  • Clerk account

Installation

  1. Clone the repository
git clone https://github.com/yourusername/insta-scrapper.git
cd insta-scrapper
  1. Install dependencies
npm install
  1. Configure environment variables

Create a .env file in the root directory:

# Database
DATABASE_URL=your-postgresql-database-url

# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your-clerk-publishable-key
CLERK_SECRET_KEY=your-clerk-secret-key

# App URLs
NEXT_PUBLIC_APP_URL="http://localhost:3000"

# Rate Limiting
RATE_LIMIT_MAX=100 
RATE_LIMIT_WINDOW=60000 
  1. Set up the database
npx prisma migrate dev
  1. Start the development server
npm run dev
  1. Open http://localhost:3000 in your browser

👥 Contributing

We're excited to welcome contributions to InstaScrapr! Whether it's bug fixes, new features, or documentation improvements, your help is appreciated.

How to Contribute

  1. Fork the repository
  2. Create a new branch
    git checkout -b feature/amazing-feature
  3. Make your changes
  4. Run tests
    npm run test
  5. Commit your changes
    git commit -m 'Add some amazing feature'
  6. Push to the branch
    git push origin feature/amazing-feature
  7. Open a Pull Request

Development Guidelines

  • Follow the existing code style and conventions
  • Write clean, maintainable, and testable code
  • Add appropriate documentation and comments
  • Include tests for new features

Ideas for Contributions

  • UI Improvements: Enhance user interface and experience
  • Performance Optimization: Improve loading times and efficiency
  • Documentation: Improve or expand documentation
  • Internationalization: Add support for multiple languages
  • Analytics Features: Add new metrics or visualization options
  • Integration: Connect with additional services or platforms

🗺️ Roadmap

  • User Roles and Permissions: Admin, team member access levels
  • Instagram Stories Analytics: Extend analysis to Stories
  • Competitor Comparison: Compare metrics with competitor profiles
  • AI-Powered Insights: Use AI to generate content recommendations
  • API Access: Public API for developers to build on the platform
  • Advanced Filters: More granular data filtering options
  • Team Collaboration: Tools for teams to work together on analytics

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Special thanks to all our contributors and the amazing open-source projects that make InstaScrapr possible:


Made with ❤️ by the InstaScrapr Team

Report Bug · Request Feature

About

Resources

Stars

Watchers

Forks

Contributors