| Name | shutterstock-analysis JSON |
| Version |
0.0.2
JSON |
| download |
| home_page | https://github.com/thinh-vu/vnnews |
| Summary | The internet's very first python package supports analyzing the Shutterstock public data, which helps creators optimize their creative portfolio and earn more income with less effort. |
| upload_time | 2022-12-14 15:39:45 |
| maintainer | |
| docs_url | None |
| author | Thinh Vu |
| requires_python | >=3.7 |
| license | |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# shutterstock_analysis
> The internet's first python package supports analyzing the Shutterstock public data, which helps creators optimize their creative portfolio and earn more income with less effort.
`shutterstock_analysis` relies on public APIs, similar to how you use the web browser to access Shutterstock service to provide you the underlay insights. It is **FREE** and has **NO LIMITATIONS**.
You can support this project on Patreon (or Momo in Vietnam) based on how you feel it is helpful. Scroll the end of this page for more details.
<div>
<img src="https://img.shields.io/pypi/pyversions/shutterstock_analysis?logoColor=brown&style=plastic" alt= "Version"/>
<img src="https://img.shields.io/pypi/dm/shutterstock_analysis" alt="Download Badge"/>
<img src="https://img.shields.io/github/last-commit/thinh-vu/shutterstock_analysis" alt="Commit Badge"/>
<img src="https://img.shields.io/github/license/thinh-vu/shutterstock_analysis?color=red" alt="License Badge"/>
</div>
---
# II. REFERENCES
## 2.1. How to use this package?
- Install the stable version: `pip install shutterstock_analysis`
- You can install the latest `shutterstock_analysis` version from source with the following command:
`pip install git+https://github.com/thinh-vu/shutterstock_analysis.git@main`
_(*) You might need to insert a `!` before your command when running terminal commands on Google Colab._
- To start using functions, you need to import them: `from shutterstock_analysis import *`
## 2.2. Function references
> You can also read the function suggestion on your IDE which loads the documentation from the doc string. It's fairly simple, trust me!
### 2.2.1. Image search
- Get image search results from multiple Shutterstock result pages:
`search_df = image_search('ha giang', page_limit=10)`
- Get bulk photos details:
`bulk_photo_detail = bulk_photo_detail(search_df, limit=100)`
### 2.2.2. Creative video search
> Although the data for the Editorial video is available, I decided to skip that option since it's not practical for my use case. Do feel free to develop it on your own if it's needed.
- Get video search results from multiple Shutterstock result pages:
`search_df = image_search('ha giang', page_limit=10)`
- Get bulk videos details:
`bulk_photo_detail = bulk_photo_detail(search_df, limit=100)`
### 2.2.3. Export data:
- This is the simplest way to export data from python to a CSV file which you can analyze easily either with Excel or Google Sheets.
- Export search results: `search_df.to_csv('YOUR_PATH_TO_FILE.csv', index=False)`
- Export photo details: `bulk_photo_detail.to_csv('YOUR_PATH_TO_FILE.csv', index=False)`
## Limitations
- Support photo and video searches:
- Photo Search (Non-Editorial and Editorial)
- Video Creative Search. Skip Editorial Video search.
- Need to avoid abusing the API, which might lead to the service provider blocking the bot traffic.
# III. APENDICES
## Photo search query structure:
<details>
<summary>Default photo search</summary>
```https://www.shutterstock.com/_next/data/abgKsgPYfFDoIqIr0JlX0/en/_shutterstock/search/ha-giang.json?image_type=photo&term=ha-giang```
Default Search UI:
</details>
<details>
<summary>Advanced photo search</summary>
```https://www.shutterstock.com/_next/data/abgKsgPYfFDoIqIr0JlX0/en/_shutterstock/search/ha-giang.json?image_type=photo&term=ha-giang&page=2&&contributor=Big+Pearl&category=Nature&sort=newest&release=editorial&mreleased=true&exclude=car%2C+bike&artistsInclude=VN&authentic=true```
Advanced Search UI
</details>
## Video creative search query structure
<details>
<summary>Default Video search</summary>
```https://www.shutterstock.com/_next/data/qaf5FoOwtgZ0aXCZ3JlVY/en/_shutterstock/video/search/ha-giang.json?term=ha-giang```
</details>
<details>
<summary>Advanced Video Creative search</summary>
```https://www.shutterstock.com/_next/data/qaf5FoOwtgZ0aXCZ3JlVY/en/_shutterstock/video/search/ha-giang.json?term=ha-giang&page=2&sort=newest&res=4k&aspect_ratio=16%3A9&duration=0-90&fps=30&mreleased=true&people_number=2&contributor=bui+minh+vu&artistsInclude=VN&exclude=car%2C+bike&release=editorial&category=Nature&safe=off```
</details>
# IV. 🙋♂️ CONTACT INFORMATION
You can contact me at one of my social network profiles:
<div id="badges" align="center">
<a href="https://www.linkedin.com/in/thinh-vu">
<img src="https://img.shields.io/badge/LinkedIn-blue?style=for-the-badge&logo=linkedin&logoColor=white" alt="LinkedIn Badge"/>
</a>
<a href="https://www.messenger.com/t/mr.thinh.ueh">
<img src="https://img.shields.io/badge/Messenger-00B2FF?style=for-the-badge&logo=messenger&logoColor=white" alt="Messenger Badge"/>
<a href="https://www.youtube.com/channel/UCYgG-bmk92OhYsP20TS0MbQ">
<img src="https://img.shields.io/badge/YouTube-red?style=for-the-badge&logo=youtube&logoColor=white" alt="Youtube Badge"/>
</a>
</a>
<a href="https://github.com/thinh-vu">
<img src="https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white" alt="Github Badge"/>
</a>
</div>
---
If you want to support my open-source projects, you can "buy me a coffee" via [Patreon](https://patreon.com/thinhvu?utm_medium=clipboard_copy&utm_source=copyLink&utm_campaign=creatorshare_creator) or Momo e-wallet (VN). Your support will help to maintain my blog hosting fee & to develop high-quality content.
Raw data
{
"_id": null,
"home_page": "https://github.com/thinh-vu/vnnews",
"name": "shutterstock-analysis",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Thinh Vu",
"author_email": "mrthinh@live.com",
"download_url": "https://files.pythonhosted.org/packages/6e/4c/a1610355965b67a3458b614fb3a5c0869a3bf7e74f1e22e2b25c7521ef26/shutterstock_analysis-0.0.2.tar.gz",
"platform": null,
"description": "# shutterstock_analysis\n> The internet's first python package supports analyzing the Shutterstock public data, which helps creators optimize their creative portfolio and earn more income with less effort.\n\n`shutterstock_analysis` relies on public APIs, similar to how you use the web browser to access Shutterstock service to provide you the underlay insights. It is **FREE** and has **NO LIMITATIONS**. \n\nYou can support this project on Patreon (or Momo in Vietnam) based on how you feel it is helpful. Scroll the end of this page for more details.\n\n<div>\n <img src=\"https://img.shields.io/pypi/pyversions/shutterstock_analysis?logoColor=brown&style=plastic\" alt= \"Version\"/>\n <img src=\"https://img.shields.io/pypi/dm/shutterstock_analysis\" alt=\"Download Badge\"/>\n <img src=\"https://img.shields.io/github/last-commit/thinh-vu/shutterstock_analysis\" alt=\"Commit Badge\"/>\n <img src=\"https://img.shields.io/github/license/thinh-vu/shutterstock_analysis?color=red\" alt=\"License Badge\"/>\n</div>\n\n---\n\n# II. REFERENCES\n## 2.1. How to use this package?\n- Install the stable version: `pip install shutterstock_analysis`\n- You can install the latest `shutterstock_analysis` version from source with the following command:\n`pip install git+https://github.com/thinh-vu/shutterstock_analysis.git@main`\n\n_(*) You might need to insert a `!` before your command when running terminal commands on Google Colab._\n\n- To start using functions, you need to import them: `from shutterstock_analysis import *`\n\n## 2.2. Function references\n\n> You can also read the function suggestion on your IDE which loads the documentation from the doc string. It's fairly simple, trust me!\n\n### 2.2.1. Image search\n- Get image search results from multiple Shutterstock result pages:\n \n `search_df = image_search('ha giang', page_limit=10)`\n\n- Get bulk photos details:\n\n `bulk_photo_detail = bulk_photo_detail(search_df, limit=100)`\n\n### 2.2.2. Creative video search\n> Although the data for the Editorial video is available, I decided to skip that option since it's not practical for my use case. Do feel free to develop it on your own if it's needed.\n\n- Get video search results from multiple Shutterstock result pages:\n \n `search_df = image_search('ha giang', page_limit=10)`\n\n- Get bulk videos details:\n \n `bulk_photo_detail = bulk_photo_detail(search_df, limit=100)`\n\n### 2.2.3. Export data:\n- This is the simplest way to export data from python to a CSV file which you can analyze easily either with Excel or Google Sheets.\n - Export search results: `search_df.to_csv('YOUR_PATH_TO_FILE.csv', index=False)`\n\n - Export photo details: `bulk_photo_detail.to_csv('YOUR_PATH_TO_FILE.csv', index=False)`\n\n## Limitations\n- Support photo and video searches: \n - Photo Search (Non-Editorial and Editorial)\n - Video Creative Search. Skip Editorial Video search.\n\n- Need to avoid abusing the API, which might lead to the service provider blocking the bot traffic.\n\n# III. APENDICES\n\n## Photo search query structure:\n <details>\n <summary>Default photo search</summary>\n\n ```https://www.shutterstock.com/_next/data/abgKsgPYfFDoIqIr0JlX0/en/_shutterstock/search/ha-giang.json?image_type=photo&term=ha-giang```\n\n Default Search UI:\n\n \n\n </details>\n\n <details>\n <summary>Advanced photo search</summary>\n\n ```https://www.shutterstock.com/_next/data/abgKsgPYfFDoIqIr0JlX0/en/_shutterstock/search/ha-giang.json?image_type=photo&term=ha-giang&page=2&&contributor=Big+Pearl&category=Nature&sort=newest&release=editorial&mreleased=true&exclude=car%2C+bike&artistsInclude=VN&authentic=true```\n\n Advanced Search UI\n\n \n \n </details>\n\n## Video creative search query structure\n<details>\n <summary>Default Video search</summary>\n \n ```https://www.shutterstock.com/_next/data/qaf5FoOwtgZ0aXCZ3JlVY/en/_shutterstock/video/search/ha-giang.json?term=ha-giang```\n\n</details>\n\n<details>\n <summary>Advanced Video Creative search</summary>\n \n ```https://www.shutterstock.com/_next/data/qaf5FoOwtgZ0aXCZ3JlVY/en/_shutterstock/video/search/ha-giang.json?term=ha-giang&page=2&sort=newest&res=4k&aspect_ratio=16%3A9&duration=0-90&fps=30&mreleased=true&people_number=2&contributor=bui+minh+vu&artistsInclude=VN&exclude=car%2C+bike&release=editorial&category=Nature&safe=off```\n\n</details>\n\n# IV. \ud83d\ude4b\u200d\u2642\ufe0f CONTACT INFORMATION\nYou can contact me at one of my social network profiles:\n\n<div id=\"badges\" align=\"center\">\n <a href=\"https://www.linkedin.com/in/thinh-vu\">\n <img src=\"https://img.shields.io/badge/LinkedIn-blue?style=for-the-badge&logo=linkedin&logoColor=white\" alt=\"LinkedIn Badge\"/>\n </a>\n <a href=\"https://www.messenger.com/t/mr.thinh.ueh\">\n <img src=\"https://img.shields.io/badge/Messenger-00B2FF?style=for-the-badge&logo=messenger&logoColor=white\" alt=\"Messenger Badge\"/>\n <a href=\"https://www.youtube.com/channel/UCYgG-bmk92OhYsP20TS0MbQ\">\n <img src=\"https://img.shields.io/badge/YouTube-red?style=for-the-badge&logo=youtube&logoColor=white\" alt=\"Youtube Badge\"/>\n </a>\n </a>\n <a href=\"https://github.com/thinh-vu\">\n <img src=\"https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white\" alt=\"Github Badge\"/>\n </a>\n</div>\n\n---\n\nIf you want to support my open-source projects, you can \"buy me a coffee\" via [Patreon](https://patreon.com/thinhvu?utm_medium=clipboard_copy&utm_source=copyLink&utm_campaign=creatorshare_creator) or Momo e-wallet (VN). Your support will help to maintain my blog hosting fee & to develop high-quality content.\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "The internet's very first python package supports analyzing the Shutterstock public data, which helps creators optimize their creative portfolio and earn more income with less effort.",
"version": "0.0.2",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "f9051dc12b21e21448e21e8e128b1538",
"sha256": "7e7a00c535cfb25c9fa25fd9938d33132f795df5eafa047fd842e5d70b83ace0"
},
"downloads": -1,
"filename": "shutterstock_analysis-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f9051dc12b21e21448e21e8e128b1538",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 6582,
"upload_time": "2022-12-14T15:39:42",
"upload_time_iso_8601": "2022-12-14T15:39:42.900456Z",
"url": "https://files.pythonhosted.org/packages/b5/eb/ed511781e8cc5e0c2504599c3a92901f9a35602a48e874fbaccea0187cc5/shutterstock_analysis-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "3f84684e5c960fa465cb7ae6c017c6e7",
"sha256": "74996124e7a6efb3074e552cd8936f974abcf01bbe287ba8346c0275062f2a37"
},
"downloads": -1,
"filename": "shutterstock_analysis-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "3f84684e5c960fa465cb7ae6c017c6e7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 6282,
"upload_time": "2022-12-14T15:39:45",
"upload_time_iso_8601": "2022-12-14T15:39:45.323704Z",
"url": "https://files.pythonhosted.org/packages/6e/4c/a1610355965b67a3458b614fb3a5c0869a3bf7e74f1e22e2b25c7521ef26/shutterstock_analysis-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-14 15:39:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "thinh-vu",
"github_project": "vnnews",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "shutterstock-analysis"
}
