animethemes-api-docs/docs/graphql/guide/getting-started/index.md

---
title: Getting Started
---

# Getting Started

---

The AnimeThemes API selectively implements the [**GraphQL Tool**](https://graphql.org).

Here we will provide an overview of where the AnimeThemes API adheres to or deviates from the specification.

It is recommended that you learn how to wrap a [GraphQL API](https://graphql.org/learn/).

## Content Negotiation

The AnimeThemes API needs a `Content-Type` header.

```powershell
# A simple curl request works like this.
curl -X POST
    -H "Content-Type: application/json"
    -d "{\"query\": \"{ animePaginator { data { name } } }\"}"
    https://graphql.animethemes.moe/
```

## Document Structure

### Top Level

The AnimeThemes API specifies a custom `data` wrap for top-level members that use pagination.

The following query
```graphql
query {
    animePaginator {
        data {
            name
        }
    }
}
```
will return the JSON:
```json
{
    "data": {
        "animePaginator": {
            "data": [
                {
                    "name": ".hack//Liminality"
                },
                ...
            ]
        }
    }
}
```

### Singular Query

In case you want to return a single object, there are a few types that allow it.
The following example returns the first anime with the slug hibike_euphonium.

```graphql
query {
    anime(slug: "hibike_euphonium") {
        name
        slug
    }
}
```