animethemes-api-docs/docs/graphql/guide/sorting/index.md

title

title
Sorting

Sorting

---

Most queries provide a unique sort argument to manage resource sorting. This argument accepts a list of {type}Sort enum cases.

To sort in ascending order, the field name is enough.

To sort in descending order, append _DESC to the field name.

Query

query {
    animePagination(sort: TITLE_ROMAJI) { # Sorting in ascending direction.
        data {
            title {
                romaji
            }
        }
    }

    animePagination(sort: TITLE_ROMAJI_DESC) { # Sorting in descending direction.
        data {
            title {
                romaji
            }
        }
    }
}

Nested Sorting

In one-to-many relationships, it is possible to sort the through a relation. For example, sort animethemes by their song title.

query {
    anime(slug: "hibike_euphonium") {
        animethemes(sort: SONG_TITLE_ROMAJI) {
            song {
                title {
                    romaji
                }
            }
        }
    }
}

Relationship Sorting

It is possible to sort the relationships of the parent type.

query {
    anime(slug: "hibike_euphonium") {
        resources(sort: EXTERNAL_ID) {
            nodes {
                externalId
            }
        }
    }
}

Pivot Sorting

Sometimes, it is possible to sort results using pivot fields.

query {
    artistPagination {
        data {
            name {
                main
            }
            members(sort: MEMBER_RELEVANCE) {
                edges {
                    node {
                        name {
                            main
                        }
                    }
                    relevance
                }
            }
        }
    }
}

Multiple Sorting

By providing a list of enum cases, the sort will be applied in the order of the values provided by the client.

{
    animePagination(sort: [YEAR_DESC, SEASON]) {
        data {
            year
            season
        }
    }
}