Flipz Documentation

Flipz is a powerful marketplace scraping platform designed for modern businesses to turn web data into actionable insights.

Production Ready: Flipz is a fully functional marketplace scraping platform ready for deployment.

What is Flipz?

Flipz is a comprehensive web scraping solution that automatically monitors and extracts product data from popular marketplaces including Facebook Marketplace and Shpock. The platform provides scheduled scraping sessions, real-time data processing, and advanced filtering capabilities.

Core Features

Multi-Marketplace Support

Scrape data from Facebook Marketplace, Shpock, and other popular platforms with unified data extraction.

Scheduled Sessions

Configure automated scraping sessions with flexible intervals from seconds to months.

Advanced Filtering

Filter products by session, search terms, location, price range, and custom criteria.

Data Management

Persistent data storage with MySQL, duplicate detection, and data integrity checks.

Anti-Detection

Built-in anti-detection mechanisms including proxy rotation, user-agent randomization, and request throttling.

Stripe Integration

Secure payment processing with subscription management and automated billing.

Platform Overview

Flipz is built on a modern, enterprise-grade architecture designed for reliability, scalability, and performance.

Core Components

  • Web Application: Responsive user interface with real-time updates
  • Data Storage: Secure database with user isolation
  • Background Processing: Distributed task execution system
  • Scraping Engine: Advanced web data extraction capabilities
  • User Management: Secure authentication and authorization

Key Features

  • Cloud-Ready: Containerized deployment architecture
  • High Performance: Optimized for concurrent operations
  • Security First: Industry-standard security practices
  • Monitoring: Comprehensive system health tracking
  • Maintenance: Automated updates and data management
  • • Background job scheduling
  • • Flower monitoring
  • Data Layer
    • • MySQL 8.0 database
    • • SQLAlchemy ORM
    • • Flask-Migrate migrations
    • • Data persistence

    Scraping Sessions

    Scraping sessions are the core of Flipz's data collection system. Each session represents a configured scraping job with specific parameters.

    Session Configuration

    Parameter Description Example
    name Human-readable session identifier "iPhone London Scraper"
    urls Target marketplace URLs to scrape Facebook Marketplace search URLs
    interval_type Scheduling frequency unit minutes, hours, days
    interval_value Numeric interval value 15 (for every 15 minutes)
    max_items Maximum items to scrape per run 100

    Session States

    Active

    Session is running on schedule

    Paused

    Session is temporarily stopped

    Error

    Session encountered an error

    Inactive

    Session is disabled

    Enterprise Ready: The platform is designed for high availability and can scale to handle enterprise workloads.

    Subscription Tiers

    Basic

    $9.99/month

    • ✓ Up to 5 scraping sessions
    • ✓ 1,000 items per month
    • ✓ Basic support
    • ✓ Standard rate limits
    Premium

    $29.99/month

    • ✓ Up to 20 scraping sessions
    • ✓ 10,000 items per month
    • ✓ Priority support
    • ✓ Advanced filtering
    • ✓ API access
    Enterprise

    $99.99/month

    • ✓ Unlimited sessions
    • ✓ Unlimited items
    • ✓ 24/7 dedicated support
    • ✓ Custom integrations
    • ✓ White-label options

    Security & Compliance

    Security First: Flipz implements enterprise-grade security measures to protect your data and ensure compliance.

    Security Features

    • CSRF Protection: All forms protected against Cross-Site Request Forgery attacks
    • Secure Authentication: Industry-standard session management and password hashing
    • Data Encryption: SSL/TLS encryption for all data in transit
    • User Isolation: Complete data separation between user accounts
    • API Security: Token-based authentication for API access
    • Payment Security: PCI-compliant payment processing

    Compliance

    • GDPR compliant data handling
    • Responsible scraping practices
    • Respect for robots.txt (configurable)
    • Rate limiting and throttling