📌 pinterest-media-scraper

---

🖼 Screenshot

Web UI

---

✨ What’s New in v1.0.0

• 🎉 Initial release with core download and UI functionality
• 🔄 Improved URL normalization & validation
• 🕸️ Enhanced fallback scraping for robust media extraction
• ⚙️ Better error handling and user feedback
• 🖱️ Cleaner UI with quick-select buttons (“First 5”, “First 10”, “All Files”)

---

🛠️ All Features

• 📥 Download images & videos from Pinterest pins, boards, profiles
• 🔄 Custom BeautifulSoup scraping for media extraction
• 📦 Save media as original files or bundled ZIP archive
• ⚡ Quality & advanced settings: timeout, retries, concurrency
• 👁️‍🗨️ Media preview cards with progress tracking
• 🎛️ Professional Streamlit UI with sidebar settings & live metrics

---

🗂️ Folder Structure

pinterest-media-scraper/
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md
│   │   └── feature_request.md
│   ├── PULL_REQUEST_TEMPLATE.md
│   ├── RELEASE_TEMPLATE.md
│   └── workflows/
│       └── ci.yml
├── .gitignore
├── assets/
│   ├── pinterest-media-scraper-banner.jpg
│   └── screenshots/
│       └── screenshot.png
├── docs/
│   ├── CHANGELOG.md
│   ├── CODE_OF_CONDUCT.md
│   ├── CONTRIBUTING.md
│   ├── README.md
│   ├── SECURITY.md
│   ├── STATUS.md
│   └── USAGE.md
├── LICENSE
├── pyproject.toml
├── requirements.txt
├── src/
│   ├── app/
│   │   ├── __init__.py
│   │   ├── downloader.py
│   │   ├── ui.py
│   │   └── utils.py
│   └── main.py
└── tests/
    └── test_downloader.py

---

🕹 Usage

Prerequisites

• GitHub

Installation

# Clone the repository
git clone https://github.com/uikraft-hub/pinterest-media-scraper.git

For more detailed documentation, see our USAGE.md

---

🤝 Contributing

Please see our Contributing Guide for details.

---

Code of Conduct

This project follows our Code of Conduct. Please read it before contributing.

---

📋 Roadmap

• Better error handling
• Initial release
• Cleaner UI

See the open issues for a full list of proposed features and known issues.

---

📝 Changelog

All notable changes to this project are documented in CHANGELOG.md.

---

📄 License

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

---

🙏 Acknowledgments

• Streamlit for rapid UI development
• BeautifulSoup for HTML parsing
• Requests for HTTP sessions
• Pillow for media handling

---

📞 Support

• 📧 Email: ujjwalkrai@gmail.com
• 🐛 Issues: Repo Issues
• 🔓 Security: Repo Security
• ⛏ Pull Request: Repo Pull Request
• 📖 Docs: Repo Documentation
• 📃 Changelog: Repo Changelog

---

🔗 Connect

📝 Writing & Blogging

💼 Professional

🌐 Social

---

Made with ❤️ by ukr

---