From 738788ad4f15fb53cb20db72bf9201ffcb90e8f2 Mon Sep 17 00:00:00 2001 From: CleVERunc Date: Sun, 11 Jan 2026 11:51:16 +0530 Subject: [PATCH 1/3] docs: add initial documentation for Getty Images data source Adds a high-level description of proposed queries and metadata returned by the Getty Images API for Quantifying the Commons. --- docs/getty-images-data-source.md | 63 ++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 docs/getty-images-data-source.md diff --git a/docs/getty-images-data-source.md b/docs/getty-images-data-source.md new file mode 100644 index 00000000..be2cee12 --- /dev/null +++ b/docs/getty-images-data-source.md @@ -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. From 0be966cd5beaebf84a4a4d4f9da82429f2f5481c Mon Sep 17 00:00:00 2001 From: CleVERunc Date: Tue, 13 Jan 2026 13:05:33 +0530 Subject: [PATCH 2/3] docs: add Getty Images to sources.md --- sources.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/sources.md b/sources.md index cb89aa62..d5bf249f 100644 --- a/sources.md +++ b/sources.md @@ -183,3 +183,26 @@ language edition of wikipedia. It runs on the Meta-Wiki API. - No API key required - Query limit: It is rate-limited only to prevent abuse - Data available through XML or JSON format + + +## Getty Images + +**Description:** +The Getty Images API provides access to metadata for a large collection of +commercial visual content, including images, illustrations, videos, and +editorial media from Getty Images and iStock. + +The API exposes descriptive and licensing-related metadata without requiring +access to the media files themselves, making it suitable for analysing patterns +in licensed visual content. + +**API documentation link:** +- https://developers.gettyimages.com/docs/ + +**API information:** +- API key required +- Base URL: https://api.gettyimages.com/v3/ +- Data available in JSON format +- Supports searching assets and retrieving metadata, including licensing and + usage restrictions + From c96586ed3924044a773ef014cb7611907597f5d2 Mon Sep 17 00:00:00 2001 From: CleVERunc Date: Tue, 13 Jan 2026 17:27:19 +0530 Subject: [PATCH 3/3] docs: remove Getty Images standalone doc --- docs/getty-images-data-source.md | 63 -------------------------------- 1 file changed, 63 deletions(-) delete mode 100644 docs/getty-images-data-source.md diff --git a/docs/getty-images-data-source.md b/docs/getty-images-data-source.md deleted file mode 100644 index be2cee12..00000000 --- a/docs/getty-images-data-source.md +++ /dev/null @@ -1,63 +0,0 @@ -# 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.