-
-
Notifications
You must be signed in to change notification settings - Fork 72
docs: add initial documentation for Getty Images data source #264
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Closed
Geethanjali2412-K
wants to merge
3
commits into
creativecommons:main
from
Geethanjali2412-K:getty-images-docs
Closed
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,63 @@ | ||
| # Getty Images as a Data Source | ||
|
|
||
| ## Overview | ||
|
|
||
| The Getty Images API provides access to information about a very large | ||
| collection of visual content, including images, illustrations, and videos | ||
| from Getty Images and iStock. | ||
|
|
||
| Instead of providing the actual media files, the API focuses on returning | ||
| metadata. This metadata describes the content, its creator, and how it is | ||
| licensed or restricted for use. Because of this, the API can be useful for | ||
| studying patterns in licensed creative works without storing or distributing | ||
| the media itself. | ||
|
|
||
| --- | ||
|
|
||
| ## Proposed Queries | ||
|
|
||
| Using the Getty Images API, several types of queries could be explored to | ||
| understand creative content at a high level. | ||
|
|
||
| For example, it is possible to: | ||
|
|
||
| - Search for visual content using keywords or subject terms to understand | ||
| common themes or topics. | ||
| - Filter content by asset type, such as images, illustrations, or videos. | ||
| - Query assets based on licensing or usage restrictions to compare different | ||
| license models. | ||
| - Retrieve metadata for specific assets using their unique identifiers. | ||
|
|
||
| These types of queries help describe how creative works are organised, | ||
| categorised, and licensed across a large content library. | ||
|
|
||
| --- | ||
|
|
||
| ## Data Returned | ||
|
|
||
| When a query is made, the Getty Images API returns structured metadata about | ||
| each asset. This metadata typically includes: | ||
|
|
||
| - A unique identifier for the asset | ||
| - A title or short description of the content | ||
| - Information about the creator or contributor | ||
| - Details about the license model or usage restrictions | ||
| - Keywords or categories associated with the content | ||
| - The type of asset, such as image or video | ||
|
|
||
| This information provides context about the content and how it can be used, | ||
| without requiring access to the actual media files. | ||
|
|
||
| --- | ||
|
|
||
| ## Relevance to Quantifying the Commons | ||
|
|
||
| The metadata provided by the Getty Images API could support the goals of | ||
| Quantifying the Commons by enabling analysis of licensed creative works at | ||
| scale. | ||
|
|
||
| For example, this data could help examine trends such as the distribution of | ||
| license types, the kinds of creative content being produced, or how content | ||
| is categorised over time. By focusing on metadata rather than media files, | ||
| the project can analyse creative ecosystems while respecting usage and | ||
| licensing constraints. |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.