{"id":19454139,"url":"https://github.com/ultralytics/flickr_scraper","last_synced_at":"2025-10-04T19:12:59.281Z","repository":{"id":40332812,"uuid":"242235660","full_name":"ultralytics/flickr_scraper","owner":"ultralytics","description":"Simple Flickr Image Scraper","archived":false,"fork":false,"pushed_at":"2025-05-11T00:13:41.000Z","size":97,"stargazers_count":225,"open_issues_count":7,"forks_count":64,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-05-23T20:02:38.952Z","etag":null,"topics":["flickr","flickr-api","image-downloader","image-downloader-python","image-scraper","image-scraping","photos","scraper"],"latest_commit_sha":null,"homepage":"https://ultralytics.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ultralytics.png","metadata":{"funding":{"github":"glenn-jocher","patreon":"ultralytics","open_collective":"ultralytics"},"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-02-21T21:41:34.000Z","updated_at":"2025-05-22T15:31:25.000Z","dependencies_parsed_at":"2024-06-09T02:43:44.566Z","dependency_job_id":"9f9b1878-2710-4f10-b5f3-310f01394e5c","html_url":"https://github.com/ultralytics/flickr_scraper","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/ultralytics/flickr_scraper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultralytics%2Fflickr_scraper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultralytics%2Fflickr_scraper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultralytics%2Fflickr_scraper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultralytics%2Fflickr_scraper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ultralytics","download_url":"https://codeload.github.com/ultralytics/flickr_scraper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultralytics%2Fflickr_scraper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278360315,"owners_count":25974261,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flickr","flickr-api","image-downloader","image-downloader-python","image-scraper","image-scraping","photos","scraper"],"created_at":"2024-11-10T17:08:08.330Z","updated_at":"2025-10-04T19:12:59.244Z","avatar_url":"https://github.com/ultralytics.png","language":"Python","readme":"\u003ca href=\"https://www.ultralytics.com/\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/ultralytics/assets/main/logo/Ultralytics_Logotype_Original.svg\" width=\"320\" alt=\"Ultralytics logo\"\u003e\u003c/a\u003e\n\n# 🚀 Introduction\n\nThe Flickr Scraper is a [Python](https://www.python.org/) tool designed to help you gather images from [Flickr](https://www.flickr.com/) for creating custom datasets, particularly useful for [Ultralytics YOLO](https://docs.ultralytics.com/models/yolo11/) model training. Based on your search criteria, this tool simplifies the process of collecting relevant images for various [computer vision tasks](https://docs.ultralytics.com/tasks/), streamlining your [dataset preparation](https://docs.ultralytics.com/guides/data-collection-and-annotation/) workflow. Learn more about datasets in our blog post on the [best computer vision datasets](https://www.ultralytics.com/blog/exploring-the-best-computer-vision-datasets-in-2025).\n\n[![Ultralytics Actions](https://github.com/ultralytics/flickr_scraper/actions/workflows/format.yml/badge.svg)](https://github.com/ultralytics/flickr_scraper/actions/workflows/format.yml)\n[![Ultralytics Discord](https://img.shields.io/discord/1089800235347353640?logo=discord\u0026logoColor=white\u0026label=Discord\u0026color=blue)](https://discord.com/invite/ultralytics)\n[![Ultralytics Forums](https://img.shields.io/discourse/users?server=https%3A%2F%2Fcommunity.ultralytics.com\u0026logo=discourse\u0026label=Forums\u0026color=blue)](https://community.ultralytics.com/)\n[![Ultralytics Reddit](https://img.shields.io/reddit/subreddit-subscribers/ultralytics?style=flat\u0026logo=reddit\u0026logoColor=white\u0026label=Reddit\u0026color=blue)](https://reddit.com/r/ultralytics)\n\n## 🌟 Key Features\n\n- **Keyword Search**: Find images on Flickr using specific keywords relevant to your project.\n- **Direct Download**: Easily download images to assemble your [computer vision](https://www.ultralytics.com/glossary/computer-vision-cv) [dataset](https://www.ultralytics.com/glossary/benchmark-dataset).\n- **Streamlined Data Collection**: Simplify the process of gathering training data for [model training](https://docs.ultralytics.com/modes/train/) with YOLO models.\n\n## 🔧 Requirements\n\nEnsure you have Python 3.7 or later installed. The necessary dependencies can be installed using [pip](https://pip.pypa.io/en/stable/):\n\n```bash\npip install -U -r requirements.txt\n```\n\nKey packages include:\n\n- `flickrapi`: A Python wrapper for the Flickr API, essential for interacting with Flickr services. You can find more details on the [`flickrapi` PyPI page](https://pypi.org/project/flickrapi/).\n\n## 🛠️ Installation\n\nTo set up the Flickr scraper on your local machine, follow these steps using [Git](https://git-scm.com/):\n\n```bash\n# Clone the repository\ngit clone https://github.com/ultralytics/flickr_scraper\n\n# Navigate to the project directory\ncd flickr_scraper\n\n# Install the required packages\npip install -U -r requirements.txt\n```\n\n## ⚙️ Running the Scraper\n\nBefore you begin scraping images:\n\n1.  **Get a Flickr API Key**: Obtain your unique API key and secret by applying [here](https://www.flickr.com/services/apps/create/apply).\n2.  **Configure API Credentials**: Insert your API key and secret into the `flickr_scraper.py` script:\n\n```python\n# flickr_scraper.py\n# Replace with your actual Flickr API key and secret\nkey = \"YOUR_API_KEY\"\nsecret = \"YOUR_API_SECRET\"\n```\n\n3.  **Execute the Script**: Run the script from your terminal, specifying your search query, the number of images to fetch (`--n`), and the `--download` flag to save them locally. Downloaded images are saved by default to the `flickr_scraper/images/` directory, organized into subfolders based on the search query.\n\n    **Important**: Be mindful of Flickr's API rate limits and terms of service. Excessive requests may lead to temporary or permanent blocking. Refer to the official [Flickr API documentation](https://www.flickr.com/services/developer/api/) for detailed usage guidelines.\n\nExample command to download 10 images matching 'honeybees on flowers':\n\n```bash\npython3 flickr_scraper.py --search 'honeybees on flowers' --n 10 --download\n```\n\nYou should see output indicating the download progress:\n\n```plaintext\n0/10 https://live.staticflickr.com/21/38596887_40df118fd9_o.jpg\n...\n9/10 https://live.staticflickr.com/1770/43276172331_e779b8c161_o.jpg\nDone. (4.1s)\nAll images saved to /Users/glennjocher/PycharmProjects/flickr_scraper/images/honeybees_on_flowers/\n```\n\nThe downloaded images will be available in the specified folder (e.g., `images/honeybees_on_flowers/`), ready for annotation, further processing, or direct use in training your models.\n\n\u003cimg src=\"https://user-images.githubusercontent.com/26833433/75074332-4792c600-54b0-11ea-8c98-22acf58ba8e7.jpg\" width=\"600\" alt=\"Example scraped image of a honeybee on a flower\"\u003e\n\n## 📜 Citation\n\nIf the Flickr Scraper tool helps your research or work, please consider citing it using the following DOI:\n\n[![DOI](https://zenodo.org/badge/242235660.svg)](https://zenodo.org/badge/latestdoi/242235660)\n\n## 🤝 Contributing\n\nContributions are welcome! We value input from the community to fix bugs, add features, or improve documentation. Please see our [Contributing Guide](https://docs.ultralytics.com/help/contributing/) for details on how to get started. Don't forget to share your experiences and feedback by completing our [Survey](https://www.ultralytics.com/survey?utm_source=github\u0026utm_medium=social\u0026utm_campaign=Survey). Thank you 🙏 to all our contributors!\n\n[![Ultralytics open-source contributors](https://raw.githubusercontent.com/ultralytics/assets/main/im/image-contributors.png)](https://github.com/ultralytics/ultralytics/graphs/contributors)\n\n## ©️ License\n\nUltralytics provides two licensing options for this project:\n\n- **AGPL-3.0 License**: An [OSI-approved open-source license](https://opensource.org/license/agpl-v3), ideal for students and enthusiasts who wish to contribute and share improvements publicly. See the [LICENSE](https://github.com/ultralytics/flickr_scraper/blob/main/LICENSE) file for details.\n- **Enterprise License**: Designed for commercial applications, this license allows for the integration of Ultralytics software and AI models into commercial products and services without the open-source requirements of AGPL-3.0. If your use case involves commercial deployment, please contact us through [Ultralytics Licensing](https://www.ultralytics.com/license).\n\n## 📬 Contact\n\nFor bug reports, feature suggestions, or contributions, please visit [GitHub Issues](https://github.com/ultralytics/flickr_scraper/issues). For broader questions and discussions about Ultralytics projects, join our active community on [Discord](https://discord.com/invite/ultralytics)! Explore the full range of our resources at [Ultralytics Docs](https://docs.ultralytics.com/).\n\n\u003cbr\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-github.png\" width=\"3%\" alt=\"Ultralytics GitHub\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://www.linkedin.com/company/ultralytics/\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-linkedin.png\" width=\"3%\" alt=\"Ultralytics LinkedIn\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://twitter.com/ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-twitter.png\" width=\"3%\" alt=\"Ultralytics Twitter\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://youtube.com/ultralytics?sub_confirmation=1\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-youtube.png\" width=\"3%\" alt=\"Ultralytics YouTube\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://www.tiktok.com/@ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-tiktok.png\" width=\"3%\" alt=\"Ultralytics TikTok\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://ultralytics.com/bilibili\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-bilibili.png\" width=\"3%\" alt=\"Ultralytics BiliBili\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://discord.com/invite/ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-discord.png\" width=\"3%\" alt=\"Ultralytics Discord\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n","funding_links":["https://github.com/sponsors/glenn-jocher","https://patreon.com/ultralytics","https://opencollective.com/ultralytics"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fultralytics%2Fflickr_scraper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fultralytics%2Fflickr_scraper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fultralytics%2Fflickr_scraper/lists"}