Change Log

Below is a log of changes to the Common Sense Media API. Each change can be described as either a breaking change or an ongoing change.

  • Breaking changes When we make any backwards-incompatible changes, we release a new version of the API (e.g. v3 -> v4). In addition to being assigned a new API version, these changes are marked in the changelog with the 💥 symbol. Older versions will remain active during a sunsetting time period of at least 6 months. All partners will be informed when a new version is available and what the previous version's expiration date will be.
  • Ongoing changes Ongoing changes are backwards-compatible, and are added on a regular basis. These include new features and bug fixes. You don't need to update your API version to get these updates.

Key

❇️ New feature
⬆️ Improvement
🔧 Fix
💥 Breaking change
🔒 Security-related
📄 Documentation only

August 26, 2026

  • 📄 Updated Swagger documentation to add the missing contentGrid[playability] item.
  • 📄 Updated Swagger documentation to change contentGrid[roleModel] to the correct output contentGrid[role_model].

August 24, 2026

Release 3.2.1

  • ❇️ Editors' Picks lists are now available in the API! See endpoint documentation for all the details.
  • 🔧 Fixed issue where submitting more than 20 instances of the id query string parameter resulted in a 500.
  • ⬆️ Made error message clearer when an API key in Demo status requests more than the item limit or tries to paginate results
  • 📄 Updated Swagger documentation to clarify that the pagination.totalResults property is an upper bound, not a true total.

August 17, 2026

Release 3.1.3

  • 🔧 Fixed issue were requests run in parallel instead of serially were returning results for the other request.

June 17, 2026

Release 3.1.2

  • 🔧 Fixed issue where Podcast reviews in Spanish were returning null for the mediaType property.

June 11, 2026

Release 3.1.1

  • 🔧 Fixed issue where query string parameters with brackets (e.g. characterStrengths[], stars[gte]) were not being parsed correctly, thus being ignored.

February 5, 2026

  • 📄 Added an Upgrade Guide for moving from version 2 to version 3.

November 6, 2025

Release 3.1.0

  • ❇️ Added ability to batch request specific reviews by uuid in the /reviews endpoint. See documentation for details.

October 30, 2025

Release 3.0.2

  • 🔧 Fixed issue in the /reviews endpoint where talkingPoints without values were returning null instead of an empty object, as described in the spec.

September 30, 2025

Release 3.0.1

  • 🔧 Fixed issue in the /reviews/terms/awards endpoint where terms were not being filtered by the mediaType query string parameter.

July 14, 2025