{"id":998,"date":"2019-06-10T17:40:07","date_gmt":"2019-06-10T17:40:07","guid":{"rendered":"http:\/\/live.ecd-demo.com\/apihelp\/?page_id=998"},"modified":"2025-07-21T16:39:04","modified_gmt":"2025-07-21T16:39:04","slug":"api-stores","status":"publish","type":"page","link":"https:\/\/apihelp.ecd-demo.com\/index.php\/documentation\/what-does-the-api-contain\/api-stores\/","title":{"rendered":"API Stores"},"content":{"rendered":"\n\n<h3 class=\"wp-block-heading\">What is a Store?<\/h3>\n\n\n\n\nThe API has several stores, each of which holds data about different entities. For example, there is:\n\n\n\n\n<ul class=\"wp-block-list\"><li>A contributor store, which holds information about actors, directors etc.<\/li><li>A content instance store, which contains the primary metadata for programs, series, season and event(linear, VOD catalogue) metadata. <\/li><li>A source store, which contains the channel and VOD content provider metadata.  <\/li><\/ul>\n\n\n\n\nEach store holds many JSON documents. All of the documents in a store conform to a JSON schema specific to the entity relevant to that store.\n\n\n\nA list of the stores in the API, together with the number of documents in each store, can be obtained with the request:\n\n\n\n\n<pre class=\"wp-block-preformatted\">https:\/\/&lt;base-url&gt;\/stores-active?api_key=&lt;api-key&gt;<\/pre>\n\n\n\n\n\n<h3 class=\"wp-block-heading\">Content Instance Stores<\/h3>\n\n\n\n\nThe API includes 6 stores that correspond to the 6 different levels of the <a href=\"\/index.php\/documentation\/reference\/red-bee-program-hierarchy\/\">Simply.TV Program Hierarchy<\/a>:\n\n\n\n\n<ul class=\"wp-block-list\"><li>series<\/li><li>season<\/li><li>multipartprogram<\/li><li>program<\/li><li>programvariation<\/li><li>event<\/li><\/ul>\n\n\n\n\nThe event store is used for both linear events and VoD packages. The eventType property within each event document indicates which of the two is described by the document.\n\n\n\nThe programvariation and multipartprogram stores are not populated in some instances of the API.\n\n\n\nSince these entities have very similar properties (they can all have titles, descriptions, genres, ratings, cast and crew, images etc), all 6 stores use the same JSON schema.\n\n\n\n\n<h3 class=\"wp-block-heading\">Other stores<\/h3>\n\n\n\n\nThe API includes 2 other stores:\n\n\n\n\n<ul class=\"wp-block-list\"><li>One for <em>sources<\/em>. A <em>source <\/em>can be either a linear channel (e.g. BBC World News) or a VoD catalogue (e.g. all the programs that a customer has asked Simply.TV to provide metadata for). The sourceType property within each source document indicates which of the two is described by the document.<\/li><li>One for <em>contributors<\/em>. A <em>contributor <\/em>is typically an actor or a director, but the store may also include things like sports teams and production companies.<\/li><\/ul>\n\n","protected":false},"excerpt":{"rendered":"<p>What is a Store? The API has several stores, each of which holds data about different entities. For example, there is: A contributor store, which holds information about actors, directors etc. A content instance store, which contains the primary metadata for programs, series, season and event(linear, VOD catalogue) metadata. A source store, which contains the [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":66,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-998","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/apihelp.ecd-demo.com\/index.php\/wp-json\/wp\/v2\/pages\/998","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/apihelp.ecd-demo.com\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/apihelp.ecd-demo.com\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/apihelp.ecd-demo.com\/index.php\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/apihelp.ecd-demo.com\/index.php\/wp-json\/wp\/v2\/comments?post=998"}],"version-history":[{"count":1,"href":"https:\/\/apihelp.ecd-demo.com\/index.php\/wp-json\/wp\/v2\/pages\/998\/revisions"}],"predecessor-version":[{"id":1487,"href":"https:\/\/apihelp.ecd-demo.com\/index.php\/wp-json\/wp\/v2\/pages\/998\/revisions\/1487"}],"up":[{"embeddable":true,"href":"https:\/\/apihelp.ecd-demo.com\/index.php\/wp-json\/wp\/v2\/pages\/66"}],"wp:attachment":[{"href":"https:\/\/apihelp.ecd-demo.com\/index.php\/wp-json\/wp\/v2\/media?parent=998"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}