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.

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 (also see Avoiding generative AI development tools — Creative Commons Open Source).
  • 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
Developer Certificate of Origin
Version 1.1

Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
1 Letterman Drive
Suite D4700
San Francisco, CA, 94129

Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.


Developer's Certificate of Origin 1.1

By making a contribution to this project, I certify that:

(a) The contribution was created in whole or in part by me and I
    have the right to submit it under the open source license
    indicated in the file; or

(b) The contribution is based upon previous work that, to the best
    of my knowledge, is covered under an appropriate open source
    license and I have the right under that license to submit that
    work with modifications, whether created in whole or in part
    by me, under the same open source license (unless I am
    permitted to submit under a different license), as indicated
    in the file; or

(c) The contribution was provided directly to me by some other
    person who certified (a), (b) or (c) and I have not modified
    it.

(d) I understand and agree that this project and the contribution
    are public and that a record of the contribution (including all
    personal information I submit with it, including my sign-off) is
    maintained indefinitely and may be redistributed consistent with
    this project or the open source license(s) involved.

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

Geethanjali2412-K commented Jan 16, 2026

Hello.. I’ve updated the PR description to fully follow the required template.
Let me know if you have any changes required.

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