{"id":23881920,"url":"https://github.com/rmncldyo/google-reverse-image-search","last_synced_at":"2025-07-11T02:33:38.210Z","repository":{"id":215962036,"uuid":"740138892","full_name":"RMNCLDYO/Google-Reverse-Image-Search","owner":"RMNCLDYO","description":"A simple python wrapper designed for leveraging Google's search by image capabilities to perform reverse image searches programatically.","archived":false,"fork":false,"pushed_at":"2024-02-05T14:06:40.000Z","size":46,"stargazers_count":16,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-14T22:52:26.940Z","etag":null,"topics":["beautifulsoup","beautifulsoup4","crawler","google","google-image","google-image-crawler","google-image-scraper","google-image-search","google-images","google-reverse-image-crawler","google-reverse-image-scraper","google-reverse-image-search","image","image-search","python","python3","requests","reverse-image-search","scraper","search-by-image"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RMNCLDYO.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-01-07T16:35:05.000Z","updated_at":"2025-04-09T10:28:27.000Z","dependencies_parsed_at":"2024-02-06T04:15:31.110Z","dependency_job_id":null,"html_url":"https://github.com/RMNCLDYO/Google-Reverse-Image-Search","commit_stats":null,"previous_names":["rmncldyo/google-reverse-image-search"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/RMNCLDYO/Google-Reverse-Image-Search","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2FGoogle-Reverse-Image-Search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2FGoogle-Reverse-Image-Search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2FGoogle-Reverse-Image-Search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2FGoogle-Reverse-Image-Search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RMNCLDYO","download_url":"https://codeload.github.com/RMNCLDYO/Google-Reverse-Image-Search/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2FGoogle-Reverse-Image-Search/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264713020,"owners_count":23652703,"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","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":["beautifulsoup","beautifulsoup4","crawler","google","google-image","google-image-crawler","google-image-scraper","google-image-search","google-images","google-reverse-image-crawler","google-reverse-image-scraper","google-reverse-image-search","image","image-search","python","python3","requests","reverse-image-search","scraper","search-by-image"],"created_at":"2025-01-04T01:59:53.146Z","updated_at":"2025-07-11T02:33:38.192Z","avatar_url":"https://github.com/RMNCLDYO.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://python.org\" title=\"Go to Python homepage\"\u003e\u003cimg src=\"https://img.shields.io/badge/Python-\u0026gt;=3.x-blue?logo=python\u0026amp;logoColor=white\" alt=\"Made with Python\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/maintained-yes-2ea44f\" alt=\"maintained - yes\"\u003e\n    \u003ca href=\"/CONTRIBUTING.md\" title=\"Go to contributions doc\"\u003e\u003cimg src=\"https://img.shields.io/badge/contributions-welcome-2ea44f\" alt=\"contributions - welcome\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://pypi.org/project/requests\"\u003e\u003cimg src=\"https://img.shields.io/badge/dependency-requests-critical\" alt=\"dependency - requests\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://pypi.org/project/beautifulsoup4\"\u003e\u003cimg src=\"https://img.shields.io/badge/dependency-beautifulsoup4-critical\" alt=\"dependency - beautifulsoup4\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg width=\"700\" src=\"https://raw.githubusercontent.com/RMNCLDYO/Google-Reverse-Image-Search/main/.github/logo.png\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/dynamic/json?label=Google+Reverse+Image+Search\u0026query=version\u0026url=https%3A%2F%2Fraw.githubusercontent.com%2FRMNCLDYO%2FGoogle-Reverse-Image-Search%2Fmain%2F.github%2Fversion.json\" alt=\"Version\"\u003e\n\u003c/p\u003e\n\n## Overview\nGoogle Reverse Image Search is an open-source Python library designed for leveraging Google's search by image capabilities to perform reverse image searches programatically. This tool is particularly useful for applications like verifying the source of an image, finding higher resolution versions, or identifying the content and context of an image. It's designed for developers, researchers, and hobbyists who require an automated, programmatic way to perform reverse image searches.\n\n## Key Features\n- Automated reverse image searches using Google's search by image feature.\n- Customizable search queries, delays and result limits.\n- Parses and formats search results, including titles and links.\n- Built-in error handling and logging.\n\n## Prerequisites\n- `Python 3.x`\n\n## Dependencies\nThe following Python packages are required:\n- `requests`: For making HTTP requests to Google.\n- `beautifulsoup4` library for parsing the results.\n\n## Installation\nClone the repository and install the required dependencies:\n```bash\ngit clone https://github.com/RMNCLDYO/Google-Reverse-Image-Search.git\ncd Google-Reverse-Image-Search\npip install -r requirements.txt\n```\n\n## Usage\n```python\nfrom reverse_image_search import GoogleReverseImageSearch\n\nrequest = GoogleReverseImageSearch()\n\nresponse = request.response(\n    query=\"Example Query\",\n    image_url=\"https://example.com/image.jpg\",\n    max_results=5\n)\n\nprint(response)\n```\n\n## Delay Parameter\n\nThe response method includes an optional `delay` parameter, designed to manage the rate of search requests. This feature is particularly useful to prevent overwhelming the server with rapid successive requests, which could potentially trigger rate limiting or temporary blocking by Google's servers.\n\nThe `delay` parameter specifies the number of `seconds` to wait before making each new page request. This delay is applied only when fetching subsequent pages, not on the first request. It's an optional parameter, and if not set, defaults to 1 second.\n\nTo use the delay feature, set the `delay` parameter in the response method:\n\n```python\nresponse = request.response(\n    query=\"Example Query\",\n    image_url=\"https://example.com/image.jpg\",\n    max_results=10,\n    delay=5 # Wait for 5 seconds before each request\n)\n```\n\n## Contributing\nContributions are welcome!\n\nPlease refer to [CONTRIBUTING.md](.github/CONTRIBUTING.md) for detailed guidelines on how to contribute to this project.\n\n## Reporting Issues\nEncountered a bug? We'd love to hear about it. Please follow these steps to report any issues:\n\n1. Check if the issue has already been reported.\n2. Use the [Bug Report](.github/ISSUE_TEMPLATE/bug_report.md) template to create a detailed report.\n3. Submit the report [here](https://github.com/RMNCLDYO/Google-Reverse-Image-Search/issues).\n\nYour report will help us make the project better for everyone.\n\n## Feature Requests\nGot an idea for a new feature? Feel free to suggest it. Here's how:\n\n1. Check if the feature has already been suggested or implemented.\n2. Use the [Feature Request](.github/ISSUE_TEMPLATE/feature_request.md) template to create a detailed request.\n3. Submit the request [here](https://github.com/RMNCLDYO/Google-Reverse-Image-Search/issues).\n\nYour suggestions for improvements are always welcome.\n\n## Versioning and Changelog\nStay up-to-date with the latest changes and improvements in each version:\n\n- [CHANGELOG.md](.github/CHANGELOG.md) provides detailed descriptions of each release.\n\n## Security\nYour security is important to us. If you discover a security vulnerability, please follow our responsible disclosure guidelines found in [SECURITY.md](.github/SECURITY.md). Please refrain from disclosing any vulnerabilities publicly until said vulnerability has been reported and addressed.\n\n## License\nLicensed under the MIT License. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frmncldyo%2Fgoogle-reverse-image-search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frmncldyo%2Fgoogle-reverse-image-search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frmncldyo%2Fgoogle-reverse-image-search/lists"}