Skip to main content

Publication

OPDS 2.0 Publication Entry

Represents a single publication (book) in an OPDS 2.0 feed.

images object[]

Cover images for the publication

  • Array [
    • heightinteger,null<int32>nullable

    Height in pixels

    hrefstringrequired

    URL to the image

    typestringrequired

    Media type of the image

    widthinteger,null<int32>nullable

    Width in pixels

  • ]
    • links object[]required

    Links for the publication (acquisition, streaming, etc.)

  • Array [
    • hrefstringrequired

    The URI or URI template for the link

    properties object
    oneOf
    null
    relstring | nullnullable

    Relation type (e.g., "self", "search", "http://opds-spec.org/acquisition")

    templatedboolean | nullnullable

    Whether the href is a URI template

    titlestring | nullnullable

    Human-readable title for the link

    typestring | nullnullable

    Media type of the linked resource

  • ]
    • metadata objectrequired

    Publication metadata (title, author, etc.)

    @typestring | nullnullable

    Schema.org type (e.g., "http://schema.org/Book")

    artist object[]

    Artists/illustrators

  • Array [
    • namestringrequired

    Name of the contributor

    sortAsstring | nullnullable

    Sort-friendly version of the name

  • ]
    • author object[]

    Authors

  • Array [
    • namestringrequired

    Name of the contributor

    sortAsstring | nullnullable

    Sort-friendly version of the name

  • ]
    • belongsTo object
    oneOf
    null
    descriptionstring | nullnullable

    Description/summary

    identifierstring | nullnullable

    Unique identifier (e.g., "urn:uuid:...")

    languagestring | nullnullable

    Language code (e.g., "en", "ja")

    modifiedstring,null<date-time>nullable

    Last modification date

    numberOfPagesinteger,null<int32>nullable

    Number of pages

    publishedstring,null<date-time>nullable

    Publication date

    publisherstring | nullnullable

    Publisher name

    subtitlestring | nullnullable

    Subtitle

    titlestringrequired

    Title of the publication

    readingProgress object
    oneOf
    null
    Publication
    {
      "images": [
        {
          "height": 0,
          "href": "string",
          "type": "string",
          "width": 0
        }
      ],
      "links": [
        {
          "href": "string",
          "properties": "null",
          "rel": "string",
          "templated": true,
          "title": "string",
          "type": "string"
        }
      ],
      "metadata": {
        "@type": "string",
        "artist": "Unknown Type: array,null",
        "author": "Unknown Type: array,null",
        "belongsTo": "null",
        "description": "string",
        "identifier": "string",
        "language": "string",
        "modified": "2024-07-29T15:51:28.071Z",
        "numberOfPages": 0,
        "published": "2024-07-29T15:51:28.071Z",
        "publisher": "string",
        "subtitle": "string",
        "title": "string"
      },
      "readingProgress": "null"
    }