Anime News Network

Anime News Network records by ann_id.

Mappings: /api/v1/map/ann/{id}.

Routes

GET/api/ann/ids

Fetched IDs and titles, sorted by ann_id. Empty: []; unknown title: null.

curl https://animap.id/api/ann/ids
[
  { "ann_id": 1, "title": "Angel Links" },
  { "ann_id": 2, "title": "Apocalypse Zero" },
  { "ann_id": 4658, "title": "Jinki:Extend" }
]

GET/api/ann/{id}

Parsed encyclopedia record. Missing ID: 404. Ratings are in /raw.

curl https://animap.id/api/ann/1
{
  "ann_id": 1,
  "type": "TV",
  "precision": "TV",
  "title": "Angel Links",
  "alternative_titles": [
    "Seihō Tenshi Angel Links",
    "星方天使エンジェルリンクス"
  ],
  "genres": ["action", "drama", "science fiction"],
  "themes": ["pirates", "space"],
  "plot_summary": "Li Meifon is the head of a free protection/security agency…",
  "episodes": 13,
  "running_time": "half hour",
  "vintage": ["1999-04-07 to 1999-06-30"],
  "start_year": 1999,
  "objectionable_content": "TA",
  "official_websites": [
    "http://www.sunrise-inc.co.jp/seihou/ANGEL-LINKS/story.html"
  ],
  "picture": "https://cdn.animenewsnetwork.com/thumbnails/max500x600/encyc/A1-51.jpg",
  "url": "https://www.animenewsnetwork.com/encyclopedia/anime.php?id=1",
  "absent": false,
  "absent_at": null,
  "related": {
    "prev": [
      {
        "ann_id": 2433,
        "relation": "adapted from",
        "is_anime": false,
        "title": null,
        "url": null
      }
    ],
    "next": [
      {
        "ann_id": 36,
        "relation": "sequel",
        "is_anime": true,
        "title": "Lady Blue",
        "url": "https://www.animenewsnetwork.com/encyclopedia/anime.php?id=36"
      }
    ]
  }
}

GET/api/ann/{id}/raw

Stored ANN XML converted to JSON: attributes use @, text uses #text, and repeated elements become arrays. Includes ratings, cast, and staff. Missing payload: 404.

curl https://animap.id/api/ann/1/raw
{
  "anime": {
    "@id": "1",
    "@type": "TV",
    "@precision": "TV",
    "@name": "Angel Links",
    "info": [
      { "@type": "Main title", "#text": "Angel Links" },
      { "@type": "Genres", "#text": "action" },
      {
        "@type": "Picture",
        "@src": "https://cdn.animenewsnetwork.com/…/A1-51.jpg"
      }
    ],
    "ratings": {
      "@nb_votes": "352",
      "@bayesian_score": "5.85776",
      "@weighted_score": "5.8028"
    },
    "cast": [
      {
        "@lang": "JA",
        "role": "Li Meifon",
        "person": { "#text": "Yuko Miyamura" }
      }
    ]
  }
}

Field reference — /api/ann/{id}

Empty arrays are [], unless noted.

Field Type Notes
ann_id integer ANN encyclopedia ID.
type string · null TV, OAV, movie, ONA, special or omnibus.
precision string · null Disambiguation label, such as TV 2 or movie series.
title string · null Main title.
alternative_titles array of strings Alternative titles across languages.
genres
themes
array of strings Genre and theme names.
plot_summary string · null Plot summary.
episodes integer · null Episode count; null for unknown or non-numeric values. Original text is in /raw.
running_time string · null Free-form runtime, such as half hour.
vintage array of strings Free-form dates, ranges, years, and regional release notes.
start_year integer · null Leading four-digit year of the first vintage value.
objectionable_content string · null Upstream content code; casing varies.
official_websites array of strings Official website URLs.
picture string · null Full cover image URL.
url string ANN entry URL. Include it when displaying ANN data.
absent boolean Missing upstream; the archived record remains available. Clears if the entry returns.
absent_at string · null First observed absence, in RFC 3339 format. null when present upstream.
related object Upstream prev and next relation arrays. Both are always present.
related[].relation string Upstream relation label; accept unfamiliar values.
related[].is_anime boolean Whether the target has an anime record here. false means its API lookup returns 404.
related[].title string · null Target title; null when is_anime is false.
related[].url string · null Target entry URL; null when is_anime is false.

Credit Anime News Network and link the entry’s url when displaying its data. See ANN’s terms of use.