Skip to content

Conversation

@Geethanjali2412-K
Copy link

@Geethanjali2412-K Geethanjali2412-K commented Jan 11, 2026

Fixes

Description

This pull request adds documentation for Getty Images as a potential data
source for the Quantifying the Commons project.

The documentation explains a proposed Getty Images API query and describes the
type of data that would be produced, using clear, high-level explanations rather
than raw API responses or media files.

Technical details

The Getty Images API (v3) 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 returns metadata only and does not require downloading or storing media
assets. Requests are authenticated using an API key and responses are returned
in JSON format.

A representative API query could:

  • Search for image assets using a keyword or subject term (for example,
    “education”)
  • Filter results by asset type (images only)
  • Request metadata related to contributors and licensing

If the results of this query were stored as a dataset, the resulting data file
could include the following headers:

  • asset_id
  • asset_type
  • title
  • description
  • creator_name
  • collection_name
  • license_model
  • usage_restrictions
  • keywords
  • created_date

This structure enables analysis of licensed creative works without downloading
or storing the underlying media files.

Tests

Not applicable (documentation-only change).

Screenshots

Not applicable.

Checklist

  • I have read and understood the Developer Certificate of Origin (DCO), below, which covers the contents of this pull request (PR).
  • My pull request doesn't include code or content generated with AI.
  • My pull request has a descriptive title (not a vague title like Update index.md).
  • My pull request targets the default branch of the repository (main or master).
  • My commit messages follow best practices.
  • My code follows the established code style of the repository.
  • I added or updated unit tests and/or test scripts for the changes I made (if applicable).
  • I added or updated documentation (if applicable).
  • I tried running the project locally and verified that there are no visible errors.

Developer Certificate of Origin

For the purposes of this DCO, "license" is equivalent to "license or public domain dedication," and "open source license" is equivalent to "open content license or public domain dedication."

Developer Certificate of Origin

Adds a high-level description of proposed queries and metadata returned by the Getty Images API for Quantifying the Commons.
@Geethanjali2412-K Geethanjali2412-K requested review from a team as code owners January 11, 2026 10:16
@Geethanjali2412-K Geethanjali2412-K requested review from TimidRobot and possumbilities and removed request for a team January 11, 2026 10:16
@cc-open-source-bot cc-open-source-bot moved this to In review in TimidRobot Jan 11, 2026
@TimidRobot TimidRobot self-assigned this Jan 12, 2026
Copy link
Member

@TimidRobot TimidRobot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull requests (PRs) that don't use the description template can't be accepted. Please update the description.

Instead of creating a new file, please add a section to sources.md. The existing entries give examples regarding what has been found to be most helpful.

It would also be helpful to document specific API usage/queries in the description of this PR.

@Geethanjali2412-K
Copy link
Author

Thank you for the feedback, that’s very helpful.

I’ll update the PR description to use the required template and move the
documentation into sources.md as suggested. I’ll also add more detail
about the specific API queries and usage in the PR description.

I’ll push the updates shortly.

@Geethanjali2412-K
Copy link
Author

I’ve updated the PR to use the required template, moved the documentation into
sources.md, and added example API usage to the PR description.
Please let me know if anything else should be adjusted.

@TimidRobot
Copy link
Member

I’ve updated the PR to use the required template, moved the documentation into sources.md, and added example API usage to the PR description. Please let me know if anything else should be adjusted.

Please update the PR description with the proposed API query and what the headers would be for the resulting data file(s).

@TimidRobot
Copy link
Member

Pull requests (PRs) that don't use the description template can't be accepted. Please update the description.

@Geethanjali2412-K This has not yet been completed.

@Geethanjali2412-K
Copy link
Author

Hello.. I’ve updated the PR description to fully follow the required template and added the proposed API query along with the expected data file headers.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: In review

Development

Successfully merging this pull request may close these issues.

2 participants