Example
If you have access to Nature, but do not have access to Downton Abbey, the Changelog response will give you episodes from Nature and from Dowton Abbey. But when you try to make a get request to an episode from Downton Abbey, you will receive a 403 status code (access denied) because you do not have access to Downton. You can, however, make a request to a Nature episode because you have access to Nature.
Endpoint
https://media.services.pbs.org/api/v1/changelog/
Object Fields
Parameter name | Type | Value | Description |
---|---|---|---|
action | string | delete, create, update | Action occurred on resource |
since | string | Format: %Y-%m-%dT%H:%M:%S | Timestamp of the action |
type | string | asset, show, franchise, special, episode, season, collection, station | Type of the resource |
id | string | CID for any of the resource types | CID of the resource |
Example Requests
You can query the API and request all changelogs. This will return a paginated response containing 0 or 25 objects.
GET https://media.services.pbs.org/api/v1/changelog/
Filter by timestamp
Datetime format accepted: %Y-%m-%dT%H:%M:%S (Example: 2017-08-05T20:14:07.272507Z)
When filtering based on datetime, the endpoint does not support multiple since parameters.
GET https://media.services.pbs.org/api/v1/changelog/?since={datetime} datetime format: 2017-10-25T20:14:07.272507Z
Filter by resource type
GET https://media.services.pbs.org/api/v1/changelog/?type={type}&type={type}
Filter by action
This endpoint can be queried to return all updated/deleted resources.
GET https://media.services.pbs.org/api/v1/changelog/?action={action}&action={action}
Filter by resource ID
GET https://media.services.pbs.org/api/v1/changelog/?id={id}&id={id}
Filter using multiple filters
GET https://media.services.pbs.org/api/v1/changelog/?type={type}&action={action}&action={action}&since={datetime} datetime format: 2017-10-25T20:14:07.272507Z
Example Response
{ "meta": { "sort": { "timestamp": { "asc": "https://media.services.pbs.org/api/v1/changelog/?sort=timestamp", "desc": "https://media.services.pbs.org/api/v1/changelog/?sort=-timestamp" } }, "filter": { "action": "https://media.services.pbs.org/api/v1/changelog/?action=", "since": "https://media.services.pbs.org/api/v1/changelog/?since=", "id": "https://media.services.pbs.org/api/v1/changelog/?id=", "type": "https://media.services.pbs.org/api/v1/changelog/?type=" }, "pagination": { "count": 312216, "per_page": 25 }, "type": "collection" }, "links": { "prev": null, "first": "https://media.services.pbs.org/api/v1/changelog/?since=2017-08-01T20%3A14%3A07.272507Z", "last": "https://media.services.pbs.org/api/v1/changelog/?page=12489&since=2017-08-01T20%3A14%3A07.272507Z", "self": "https://media.services.pbs.org/api/v1/changelog/?since=2017-08-01T20:14:07.272507Z", "next": "https://media.services.pbs.org/api/v1/changelog/?page=2&since=2017-08-01T20%3A14%3A07.272507Z" }, "jsonapi": { "version": "1.0" }, "data": [ { "links": { "self": "https://media.services.pbs.org/api/v1/episodes/cced1427-4095-453a-ac1e-fc04df10ab4a/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:36:20.664330Z" }, "id": "cced1427-4095-453a-ac1e-fc04df10ab4a", "type": "episode" }, { "links": { "self": "https://media.services.pbs.org/api/v1/assets/157a4172-4bd6-4cd0-98ea-148a2bc840e4/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:36:20.650871Z" }, "id": "157a4172-4bd6-4cd0-98ea-148a2bc840e4", "type": "asset" }, { "links": { "self": "https://media.services.pbs.org/api/v1/episodes/cced1427-4095-453a-ac1e-fc04df10ab4a/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:36:02.779843Z" }, "id": "cced1427-4095-453a-ac1e-fc04df10ab4a", "type": "episode" }, { "links": { "self": "https://media.services.pbs.org/api/v1/assets/157a4172-4bd6-4cd0-98ea-148a2bc840e4/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:36:02.772719Z" }, "id": "157a4172-4bd6-4cd0-98ea-148a2bc840e4", "type": "asset" }, { "links": { "self": "https://media.services.pbs.org/api/v1/shows/b09c09b2-4f3e-4eb4-8f90-04c946286b9f/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:58.013829Z" }, "id": "b09c09b2-4f3e-4eb4-8f90-04c946286b9f", "type": "show" }, { "links": { "self": "https://media.services.pbs.org/api/v1/assets/83c9bc2d-2ec7-4ad5-8cc3-4eb31d6aa5e8/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:57.985864Z" }, "id": "83c9bc2d-2ec7-4ad5-8cc3-4eb31d6aa5e8", "type": "asset" }, { "links": { "self": "https://media.services.pbs.org/api/v1/episodes/cced1427-4095-453a-ac1e-fc04df10ab4a/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:34.935594Z" }, "id": "cced1427-4095-453a-ac1e-fc04df10ab4a", "type": "episode" }, { "links": { "self": "https://media.services.pbs.org/api/v1/assets/157a4172-4bd6-4cd0-98ea-148a2bc840e4/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:34.930026Z" }, "id": "157a4172-4bd6-4cd0-98ea-148a2bc840e4", "type": "asset" }, { "links": { "self": "https://media.services.pbs.org/api/v1/seasons/330a3ae9-9c20-4859-b453-bd871ea4c0c0/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:33.955141Z" }, "id": "330a3ae9-9c20-4859-b453-bd871ea4c0c0", "type": "season" }, { "links": { "self": "https://media.services.pbs.org/api/v1/episodes/000a3ef1-e895-4f1e-b75a-4ac30f9dc55e/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:33.948864Z" }, "id": "000a3ef1-e895-4f1e-b75a-4ac30f9dc55e", "type": "episode" }, { "links": { "self": "https://media.services.pbs.org/api/v1/episodes/cced1427-4095-453a-ac1e-fc04df10ab4a/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:21.255922Z" }, "id": "cced1427-4095-453a-ac1e-fc04df10ab4a", "type": "episode" }, { "links": { "self": "https://media.services.pbs.org/api/v1/assets/157a4172-4bd6-4cd0-98ea-148a2bc840e4/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:21.242040Z" }, "id": "157a4172-4bd6-4cd0-98ea-148a2bc840e4", "type": "asset" }, { "links": { "self": "https://media.services.pbs.org/api/v1/episodes/000a3ef1-e895-4f1e-b75a-4ac30f9dc55e/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:18.852260Z" }, "id": "000a3ef1-e895-4f1e-b75a-4ac30f9dc55e", "type": "episode" }, { "links": { "self": "https://media.services.pbs.org/api/v1/assets/17a1ca79-eef1-48d8-b7f0-15919ccc2728/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:18.836108Z" }, "id": "17a1ca79-eef1-48d8-b7f0-15919ccc2728", "type": "asset" }, { "links": { "self": "https://media.services.pbs.org/api/v1/seasons/330a3ae9-9c20-4859-b453-bd871ea4c0c0/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:18.597937Z" }, "id": "330a3ae9-9c20-4859-b453-bd871ea4c0c0", "type": "season" }, { "links": { "self": "https://media.services.pbs.org/api/v1/episodes/000a3ef1-e895-4f1e-b75a-4ac30f9dc55e/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:18.594571Z" }, "id": "000a3ef1-e895-4f1e-b75a-4ac30f9dc55e", "type": "episode" }, { "links": { "self": "https://media.services.pbs.org/api/v1/seasons/330a3ae9-9c20-4859-b453-bd871ea4c0c0/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:07.195360Z" }, "id": "330a3ae9-9c20-4859-b453-bd871ea4c0c0", "type": "season" }, { "links": { "self": "https://media.services.pbs.org/api/v1/episodes/a3761919-bb22-423d-96fc-6fdd2624c11e/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:07.187839Z" }, "id": "a3761919-bb22-423d-96fc-6fdd2624c11e", "type": "episode" }, { "links": { "self": "https://media.services.pbs.org/api/v1/seasons/330a3ae9-9c20-4859-b453-bd871ea4c0c0/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:05.186137Z" }, "id": "330a3ae9-9c20-4859-b453-bd871ea4c0c0", "type": "season" }, { "links": { "self": "https://media.services.pbs.org/api/v1/episodes/71a2079f-def1-4c9a-98fe-b46df17d5742/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:05.175160Z" }, "id": "71a2079f-def1-4c9a-98fe-b46df17d5742", "type": "episode" }, { "links": { "self": "https://media.services.pbs.org/api/v1/episodes/cced1427-4095-453a-ac1e-fc04df10ab4a/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:03.231938Z" }, "id": "cced1427-4095-453a-ac1e-fc04df10ab4a", "type": "episode" }, { "links": { "self": "https://media.services.pbs.org/api/v1/assets/157a4172-4bd6-4cd0-98ea-148a2bc840e4/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:03.223926Z" }, "id": "157a4172-4bd6-4cd0-98ea-148a2bc840e4", "type": "asset" }, { "links": { "self": "https://media.services.pbs.org/api/v1/episodes/cced1427-4095-453a-ac1e-fc04df10ab4a/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:03.166374Z" }, "id": "cced1427-4095-453a-ac1e-fc04df10ab4a", "type": "episode" }, { "links": { "self": "https://media.services.pbs.org/api/v1/assets/157a4172-4bd6-4cd0-98ea-148a2bc840e4/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:03.162612Z" }, "id": "157a4172-4bd6-4cd0-98ea-148a2bc840e4", "type": "asset" }, { "links": { "self": "https://media.services.pbs.org/api/v1/episodes/cced1427-4095-453a-ac1e-fc04df10ab4a/" }, "attributes": { "action": "update", "timestamp": "2017-08-23T18:35:03.098681Z" }, "id": "cced1427-4095-453a-ac1e-fc04df10ab4a", "type": "episode" } ] }