Skip to main content

FullSeriesMetadataResponse

Full series metadata response including all related data

ageRatinginteger,null<int32>nullable

Age rating (e.g., 13, 16, 18)

Example: 16
alternateTitles object[]required

Alternate titles for this series

  • Array [
  • createdAtstring<date-time>required

    When the title was created

    Example: 2024-01-01T00:00:00Z
    idstring<uuid>required

    Alternate title ID

    Example: 550e8400-e29b-41d4-a716-446655440040
    labelstringrequired

    Label for this title (e.g., "Japanese", "Romaji", "English", "Korean")

    Example: Japanese
    seriesIdstring<uuid>required

    Series ID

    Example: 550e8400-e29b-41d4-a716-446655440002
    titlestringrequired

    The alternate title

    Example: 進撃の巨人
    updatedAtstring<date-time>required

    When the title was last updated

    Example: 2024-01-15T10:30:00Z
  • ]
  • createdAtstring<date-time>required

    Timestamps

    Example: 2024-01-01T00:00:00Z
    customMetadataobject | nullnullable

    Custom JSON metadata

    externalLinks object[]required

    External links to other sites

  • Array [
  • createdAtstring<date-time>required

    When the link was created

    Example: 2024-01-01T00:00:00Z
    externalIdstring | nullnullable

    ID on the external source (if available)

    Example: 12345
    idstring<uuid>required

    External link ID

    Example: 550e8400-e29b-41d4-a716-446655440060
    seriesIdstring<uuid>required

    Series ID

    Example: 550e8400-e29b-41d4-a716-446655440002
    sourceNamestringrequired

    Source name (e.g., "myanimelist", "anilist", "mangadex")

    Example: myanimelist
    updatedAtstring<date-time>required

    When the link was last updated

    Example: 2024-01-15T10:30:00Z
    urlstringrequired

    URL to the external source

    Example: https://myanimelist.net/manga/12345
  • ]
  • externalRatings object[]required

    External ratings from various sources

  • Array [
  • createdAtstring<date-time>required

    When the rating record was created

    Example: 2024-01-01T00:00:00Z
    fetchedAtstring<date-time>required

    When the rating was last fetched from the source

    Example: 2024-01-15T10:30:00Z
    idstring<uuid>required

    External rating ID

    Example: 550e8400-e29b-41d4-a716-446655440050
    ratingnumber<double>required

    Rating value (0-100)

    Example: 85.5
    seriesIdstring<uuid>required

    Series ID

    Example: 550e8400-e29b-41d4-a716-446655440002
    sourceNamestringrequired

    Source name (e.g., "myanimelist", "anilist", "mangabaka")

    Example: myanimelist
    updatedAtstring<date-time>required

    When the rating record was last updated

    Example: 2024-01-15T10:30:00Z
    voteCountinteger,null<int32>nullable

    Number of votes (if available)

    Example: 12500
  • ]
  • genres object[]required

    Genres assigned to this series

  • Array [
  • createdAtstring<date-time>required

    When the genre was created

    Example: 2024-01-01T00:00:00Z
    idstring<uuid>required

    Genre ID

    Example: 550e8400-e29b-41d4-a716-446655440010
    namestringrequired

    Genre name

    Example: Action
    seriesCountinteger,null<int64>nullable

    Number of series with this genre

    Possible values: >= 0

    Example: 42
  • ]
  • imprintstring | nullnullable

    Imprint (sub-publisher)

    Example: Vertigo
    languagestring | nullnullable

    Language (BCP47 format: "en", "ja", "ko")

    Example: en
    locks objectrequired

    Lock states for all metadata fields

    ageRatingbooleanrequired

    Whether the age_rating field is locked

    Example: false
    customMetadatabooleanrequired

    Whether the custom_metadata field is locked

    Example: false
    genresbooleanrequired

    Whether the genres are locked

    Example: false
    imprintbooleanrequired

    Whether the imprint field is locked

    Example: false
    languagebooleanrequired

    Whether the language field is locked

    Example: false
    publisherbooleanrequired

    Whether the publisher field is locked

    Example: false
    readingDirectionbooleanrequired

    Whether the reading_direction field is locked

    Example: false
    statusbooleanrequired

    Whether the status field is locked

    Example: false
    summarybooleanrequired

    Whether the summary field is locked

    Example: true
    tagsbooleanrequired

    Whether the tags are locked

    Example: false
    titlebooleanrequired

    Whether the title field is locked

    Example: false
    titleSortbooleanrequired

    Whether the title_sort field is locked

    Example: false
    totalBookCountbooleanrequired

    Whether the total_book_count field is locked

    Example: false
    yearbooleanrequired

    Whether the year field is locked

    Example: false
    publisherstring | nullnullable

    Publisher name

    Example: DC Comics
    readingDirectionstring | nullnullable

    Reading direction (ltr, rtl, ttb or webtoon)

    Example: ltr
    seriesIdstring<uuid>required

    Series ID

    Example: 550e8400-e29b-41d4-a716-446655440002
    statusstring | nullnullable

    Series status (ongoing, ended, hiatus, abandoned, unknown)

    Example: ended
    summarystring | nullnullable

    Series description/summary

    Example: The definitive origin story of Batman.
    tags object[]required

    Tags assigned to this series

  • Array [
  • createdAtstring<date-time>required

    When the tag was created

    Example: 2024-01-01T00:00:00Z
    idstring<uuid>required

    Tag ID

    Example: 550e8400-e29b-41d4-a716-446655440020
    namestringrequired

    Tag name

    Example: Completed
    seriesCountinteger,null<int64>nullable

    Number of series with this tag

    Possible values: >= 0

    Example: 15
  • ]
  • titlestringrequired

    Series title (usually same as series name)

    Example: Batman: Year One
    titleSortstring | nullnullable

    Custom sort name for ordering

    Example: Batman Year One
    totalBookCountinteger,null<int32>nullable

    Expected total book count (for ongoing series)

    Example: 4
    updatedAtstring<date-time>required
    Example: 2024-01-15T10:30:00Z
    yearinteger,null<int32>nullable

    Release year

    Example: 1987
    FullSeriesMetadataResponse
    {
    "ageRating": 16,
    "alternateTitles": [
    {
    "createdAt": "2024-01-01T00:00:00Z",
    "id": "550e8400-e29b-41d4-a716-446655440040",
    "label": "Japanese",
    "seriesId": "550e8400-e29b-41d4-a716-446655440002",
    "title": "進撃の巨人",
    "updatedAt": "2024-01-15T10:30:00Z"
    }
    ],
    "createdAt": "2024-01-01T00:00:00Z",
    "customMetadata": "Unknown Type: object,null",
    "externalLinks": [
    {
    "createdAt": "2024-01-01T00:00:00Z",
    "externalId": "12345",
    "id": "550e8400-e29b-41d4-a716-446655440060",
    "seriesId": "550e8400-e29b-41d4-a716-446655440002",
    "sourceName": "myanimelist",
    "updatedAt": "2024-01-15T10:30:00Z",
    "url": "https://myanimelist.net/manga/12345"
    }
    ],
    "externalRatings": [
    {
    "createdAt": "2024-01-01T00:00:00Z",
    "fetchedAt": "2024-01-15T10:30:00Z",
    "id": "550e8400-e29b-41d4-a716-446655440050",
    "rating": 85.5,
    "seriesId": "550e8400-e29b-41d4-a716-446655440002",
    "sourceName": "myanimelist",
    "updatedAt": "2024-01-15T10:30:00Z",
    "voteCount": 12500
    }
    ],
    "genres": [
    {
    "createdAt": "2024-01-01T00:00:00Z",
    "id": "550e8400-e29b-41d4-a716-446655440010",
    "name": "Action",
    "seriesCount": 42
    }
    ],
    "imprint": "Vertigo",
    "language": "en",
    "locks": {
    "ageRating": false,
    "customMetadata": false,
    "genres": false,
    "imprint": false,
    "language": false,
    "publisher": false,
    "readingDirection": false,
    "status": false,
    "summary": true,
    "tags": false,
    "title": false,
    "titleSort": false,
    "totalBookCount": false,
    "year": false
    },
    "publisher": "DC Comics",
    "readingDirection": "ltr",
    "seriesId": "550e8400-e29b-41d4-a716-446655440002",
    "status": "ended",
    "summary": "The definitive origin story of Batman.",
    "tags": [
    {
    "createdAt": "2024-01-01T00:00:00Z",
    "id": "550e8400-e29b-41d4-a716-446655440020",
    "name": "Completed",
    "seriesCount": 15
    }
    ],
    "title": "Batman: Year One",
    "titleSort": "Batman Year One",
    "totalBookCount": 4,
    "updatedAt": "2024-01-15T10:30:00Z",
    "year": 1987
    }