HTTP API Definition: Difference between revisions

m
mention that the client string needs to be lower-case
m (mention that the client string needs to be lower-case)
 
(67 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{TOCright}}
{{TOCright}}
= Early Draft =


Note: This is still a very early draft and has not yet been implemented!
== General ==
The HTTP XML API is only a small part of the AniDB API framework, please refer to [[API]] for an overview.


= General =
=== Clients ===


== Encoding ==
If you want to create a client you have to register it {{AniDBLink|client|here}}


All content is UTF8 encoded and gzip compressed (you may have to handle the decompressing yourself, if your HTTP library doesn't support compression of HTTP data).
=== Encoding ===
All content is UTF8 encoded and gzip compressed (you may have to handle the decompressing yourself, if your HTTP library doesn't support compression of HTTP data). Transfer is in chunks, which are part of HTTP 1.1. This is the case even when your client requested uncompressed HTTP 1.0.


== Flooding ==
=== Flooding and Caching ===
All users of this API should employ heavy local caching. Requesting the same dataset multiple times on a single day can get you banned. The same goes for request flooding. You should not request more than one page every two seconds.


All users of this API should employ heavy local caching. Requesting the same dataset multiple times on a single day can get you banned. The same goes for request flooding. You should not request more than one page every two seconds on average.
=== Anti Leech Protection ===
The API should not be used to "download" AniDB. If such attempts are detected you will get banned.


== Parameters ==
=== Parameters ===
These parameters apply to all HTTP XML API pages and should always be added to the request URLs.
 
All users of the HTTP XML API need to be registered and have to provide their registered client identifier and version number on each request.
 
Parameters:
* <tt>client={string}</tt> [required]
** client identification string (lower-case, convert if necessary), needs to be a registered client identifier under the HTTP API (this is not your project name).
 
* <tt>clientver={integer}</tt> [required]
** client version number, needs to be a valid client version number, for the given client identification string, registered under the HTTP API.
 
* <tt>protover={integer}</tt> [required]
** protocol version in use.  Possible values: 1
 
* <tt>request={string}</tt> [required]
** HTTP XML datapage requested.  See following sections.
 
 
Example:
URL: <u><nowiki>http://api.anidb.net:9001/httpapi?client={str}&clientver={int}&protover=1</nowiki></u>
 
== Data Commands ==


These parameters apply to all HTTP XML API pages and should always be added to the request URLs.
=== Anime ===
Allows retrieval of non-file or episode related information for a specific anime by AID (AniDB anime id).


All users of the HTTP XML API need to be registered and have to provide their registered client identifier and version number on each request. For more information on client registration visit [[UDP_API_Definition]].
==== Search ====
* [[API#Anime_Titles|Look here]]


==== Access ====
Base URL: <u><nowiki>http://api.anidb.net:9001/httpapi?request=anime</nowiki></u>


Parameters:
Parameters:
* client={string} [required]
* <tt>request=anime</tt>
** client identification string, needs to be a registered client identifier, see:  
* <tt>aid={integer}</tt> [required]
** AniDB anime id of the anime you want to retrieve data for.
 
 
{{eyecatch|Note|The tags node presently contains both 'spoiler' and 'localspoiler' attributes.  Both represent the same value.  Clients should use 'localspoiler'; in time, 'spoiler' will be removed.}}
 
 
{{eyecatch|Important!|The meaning of the <temporary> vote node has changed since the HTTP API was put in place.  To help keep clients compatible, the node will not be removed short term, but client consumers should be aware that this value now represents the mean of all votes (both permanent and temporary).}}
 
 
Example:
URL: <u><nowiki>http://api.anidb.net:9001/httpapi?request=anime&client={str}&clientver={int}&protover=1&aid={int}</nowiki></u>
 
===== Data =====
<pre>
<?xml version="1.0"?>
<anime id="1" restricted="false">
  <type>TV Series</type>
  <episodecount>13</episodecount>
  <startdate>1999-01-03</startdate>
  <enddate>1999-03-28</enddate>
  <titles>
    <title xml:lang="x-jat" type="main">Seikai no Monshou</title>
    <title xml:lang="cs" type="synonym">Hv&#x11B;zdn&#xFD; erb</title>
    <title xml:lang="zh-Hans" type="synonym">&#x661F;&#x754C;&#x4E4B;&#x7EB9;&#x7AE0;</title>
    <title xml:lang="en" type="short">CotS</title>
    <title xml:lang="x-jat" type="short">SnM</title>
    <title xml:lang="ja" type="official">&#x661F;&#x754C;&#x306E;&#x7D0B;&#x7AE0;</title>
    <title xml:lang="en" type="official">Crest of the Stars</title>
    <title xml:lang="fr" type="official">Crest of the Stars</title>
    <title xml:lang="pl" type="official">Crest of the Stars</title>
  </titles>
  <relatedanime>
    <anime id="4" type="Sequel">Seikai no Senki</anime>
    <anime id="6" type="Prequel">Seikai no Danshou: Tanjou</anime>
    <anime id="1623" type="Summary">Seikai no Monshou Tokubetsu Hen</anime>
  </relatedanime>
  <similaranime>
    <anime id="584" approval="75" total="89">Ginga Eiyuu Densetsu</anime>
    <anime id="2745" approval="52" total="62">Starship Operators</anime>
    <anime id="6005" approval="36" total="52">Tytania</anime>
    <anime id="192" approval="18" total="40">Mugen no Ryvius</anime>
    <anime id="630" approval="14" total="28">Uchuu no Stellvia</anime>
    <anime id="5406" approval="3" total="16">Ookami to Koushinryou</anime>
    <anime id="18" approval="2" total="11">Musekinin Kanchou Tylor</anime>
  </similaranime>
  <recommendations total="20">
    <recommendation type="Recommended" uid="567190">As has been said, a solid space opera, but where it really shines is the two protagonists and how they interact. They have misunderstandings constantly, but they just talk it out until they come to a better understanding of each other. It`s beautiful.
 
The series does have its issues. The art style and animation are fine despite the age, but the direction and editing are incredibly shoddy at times and the pacing is off where subplots are concerned. Not to mention the overly drawn out, drily delivered exposition at the start of every episode.
 
That said, at 13 episodes it`s still an easy recommendation. Watching two people work that hard at empathy is such a rare treat. Don`t miss this if you want some refreshingly straightforward romance.</recommendation>
    <recommendation type="Recommended" uid="350281">Space opera with an exciting buildup and a sublime crescendo. 4X players, don`t miss this!</recommendation>
    <recommendation type="Recommended" uid="112858">If you`re into scifi and generally more sophisticated stuff than brainless entertainment, this is a must see. Everyone else at least take a close look, you might be suprised.</recommendation>
    <recommendation type="Must See" uid="411532">Strong characters and Great plot.  One of the best Space Opera`s I`ve seen.</recommendation>
    <recommendation type="Must See" uid="284037">Awesome! Dunno what to say, but it`s just.... awesome!</recommendation>
    <recommendation type="Must See" uid="125868">This is the second best anime of all time, behind seikai no senki II closely followed by seikai no senki II.  This is a must see anime.  Excellenet plots, environment, characters, development, and re-watch value.</recommendation>
    <recommendation type="Must See" uid="691547">An awesome space opera
that tries to answer a simple yet complicated question:
Can humans be friends with aliens?
So if you`re looking for an answer watch this.
Btw think of this series as a small grandchild
of a great EPIC like LoGH
but with Lafiel in the lead</recommendation>
  </recommendations>
  <url>http://www.sunrise-inc.co.jp/seikai/</url>
  <creators>
    <name id="4303" type="Music">Hattori Katsuhisa</name>
    <name id="4234" type="Direction">Nagaoka Yasuchika</name>
    <name id="4516" type="Character Design">Watabe Keisuke</name>
    <name id="8924" type="Series Composition">Yoshinaga Aya</name>
    <name id="4495" type="Original Work">Morioka Hiroyuki</name>
  </creators>
  <description>* Based on the sci-fi novel series by http://anidb.net/cr4495 [Morioka Hiroyuki].
http://anidb.net/ch4081 [Linn Jinto]`s life changes forever when the http://anidb.net/ch7514 [Humankind Empire Abh] takes over his home planet of Martine without firing a single shot. He is soon sent off to study the http://anidb.net/t2324 [Abh] language and culture and to prepare himself for his future as a nobleman &#x2014; a future he never dreamed of, asked for, or even wanted.
Now, Jinto is entering the next phase of his training, and he is about to meet the first Abh in his life, the lovely http://anidb.net/ch28 [Lafiel]. However, Jinto is about to learn that there is more to her than meets the eye, and together they will have to fight for their very lives.</description>
  <ratings>
    <permanent count="4430">8.16</permanent>
    <temporary count="4460">8.23</temporary>
    <review count="12">8.70</review>
  </ratings>
  <picture>440.jpg</picture>
  <resources>
    <resource type="1">
      <externalentity>
        <identifier>14</identifier>
      </externalentity>
    </resource>
    <resource type="2">
      <externalentity>
        <identifier>290</identifier>
      </externalentity>
    </resource>
    <resource type="3">
      <externalentity>
        <identifier>376</identifier>
        <identifier>xzudnt</identifier>
      </externalentity>
    </resource>
    <resource type="4">
      <externalentity>
        <url>http://www.sunrise-inc.co.jp/seikai/</url>
      </externalentity>
    </resource>
    <resource type="6">
      <externalentity>
        <identifier>Crest_of_the_Stars</identifier>
      </externalentity>
    </resource>
    <resource type="7">
      <externalentity>
        <identifier>&#x661F;&#x754C;&#x306E;&#x7D0B;&#x7AE0;</identifier>
      </externalentity>
    </resource>
    <resource type="8">
      <externalentity>
        <identifier>1333</identifier>
      </externalentity>
    </resource>
    <resource type="9">
      <externalentity>
        <identifier>90291</identifier>
      </externalentity>
    </resource>
    <resource type="10">
      <externalentity>
        <identifier>1869</identifier>
      </externalentity>
    </resource>
    <resource type="14">
      <externalentity>
        <identifier>11753</identifier>
        <identifier>v</identifier>
      </externalentity>
    </resource>
    <resource type="17">
      <externalentity>
        <identifier>seikai01</identifier>
      </externalentity>
    </resource>
    <resource type="31">
      <externalentity>
        <identifier>6674</identifier>
      </externalentity>
    </resource>
  </resources>
  <tags>
    <tag id="36" parentid="2607" weight="300" localspoiler="false" globalspoiler="false" verified="true" update="2018-01-21">
      <name>military</name>
      <description>The military, also known as the armed forces, are forces authorized and legally entitled to use deadly force so as to support the interests of the state and its citizens. The task of the military is usually defined as defence of the state and its citizens and the prosecution of war against foreign powers. The military may also have additional functions within a society, including construction, emergency services, social ceremonies, and guarding critical areas.
Source: Wikipedia</description>
      <picurl>212184.jpg</picurl>
    </tag>
    <tag id="1396" parentid="2607" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2014-10-01">
      <name>immortality</name>
      <description>Immortality is the ability to live in a physical or spiritual form for an infinite or inconceivably vast length of time. Humans, whose life span is limited and who die of age, disease and external trauma, have long sought ways to extend their lives; the Epic of Gilgamesh, considered one of the first great literary works created by mankind, is primarily the quest of a hero seeking to become immortal. The advances of science, in particular medicine and engineering, and especially in the last few centuries, have helped people extend their life span and may yet continue finding ways to do so.
In fiction, immortals are not quite as uncommon as in real life, and the possible implications of endless or very long lives are often explored. Such implications include, but are not limited to: repeatedly accompanying the deaths of those dear to them; having to hide their condition from the mortals surrounding them; becoming disillusioned with their lives and being unable to kill themselves; and even staying forever trapped in the body of a specific physical age, that body most often being that of a child. As such, while many may wish for immortality, it may be little more than a curse for the few who have it.</description>
    </tag>
    <tag id="2008" parentid="2891" weight="200" localspoiler="false" globalspoiler="false" verified="true" update="2015-08-05">
      <name>small breasts</name>
      <description>This character has a bust size that is considered small.
The small size is usually a bust that would use a bra which is A or B. In anime, C may rarely enter this category.</description>
      <picurl>162720.jpg</picurl>
    </tag>
    <tag id="2604" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2018-07-08">
      <name>content indicators</name>
      <description>The content indicators branch is intended to be a less geographically specific tool than the `age rating` used by convention, for warning about things that might cause offence. Obviously there is still a degree of subjectivity involved, but hopefully it will prove useful for parents with delicate children, or children with delicate parents.
Refer to further guidance on http://wiki.anidb.net/w/Categories:Content_Indicators [the Wiki page] for how to apply tag weights for content indicators.</description>
    </tag>
    <tag id="2605" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2014-09-28">
      <name>dynamic</name>
      <description>Some of the central structural elements in anime are:
Plot Continuity
How does the plot or several plots unfold. Are they a strictly linear retelling of one big continuing story, a serial, possibly with several side stories, or is the content chopped into a set of unconnected episodes, only sharing the same setting and characters?
Stereotype Characters
Then there is the question of the character set presentation. Is it completely original, or is it your usual stereotypical character cast. Both choices have their merit, for example it would not really make much sense to reinvent the wheel for a harem anime. Fans of that genre come to expect their favourite stereotype protagonists.
Plot Twists
Finally there is the question of how complex the plot / the story unfolds. Are there side-plots that merge into the main plot leading to unexpected plot twists, or is the anime quite predictable? The latter would not be appropriate for detective stories. In harem anime on the other hand a foreseeable outcome is actually something the fans will come to expect.</description>
    </tag>
    <tag id="2607" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2009-04-29">
      <name>themes</name>
      <description>Themes describe the very central elements important to the anime stories. They set the backdrop against which the protagonists must face their challenges. Be it School Life, present Daily Life, Military action, Cyberpunk, Law and Order detective work, Sports, or the Underworld. These are only but a few of the more typical backgrounds for anime plots. Add to that a Conspiracy setting with a possible tragic outcome, the Themes span most of the imaginable subject matter relevant to anime.</description>
    </tag>
    <tag id="2608" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2012-12-04">
      <name>fetishes</name>
      <description>Everything under fetishes (except for Bishounen and Juujin) is strictly only meant for hentai (18 Restricted) and ecchi anime. In case of ecchi, it must be the main element of the show and not when there`s only some of it, for example, there`s some ecchi in Shinseiki Evangelion, but the fact you get to see Asuka`s pantsu doesn`t warrant it the schoolgirl fetish category. So be careful to which ecchi show you add fetishes; it`s fairly straightforward with hentai, though. Overall, this category tree is to satisfy the needs of people with different fetishes, so they can search for what tingles their tangle; hence why this is restricted to hentai and full ecchi shows. </description>
    </tag>
    <tag id="2609" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2018-09-01">
      <name>original work</name>
      <description>What the anime is based on! This is given as the original work credit in the OP. Mostly of academic interest, but a useful bit of info, hinting at the possible depth of story.</description>
    </tag>
    <tag id="2610" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2009-04-22">
      <name>setting</name>
      <description>The setting describes in what time and place an anime takes place. To a certain extent it describes what you can expect from the world in the anime.</description>
    </tag>
    <tag id="2611" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2014-09-08">
      <name>elements</name>
      <description>Next to Themes setting the backdrop for the protagonists in anime, there are the more detailed plot Elements that centre on character interactions: "What do characters do to each other or what is done to them?". Is it violent Action, an awe-inspiring Adventure in a foreign place, the gripping life of a Detective, a slapstick Comedy, an Ecchi Harem anime, a SciFi epic, or some Fantasy travelling adventure?</description>
    </tag>
    <tag id="2612" parentid="2610" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2016-09-04">
      <name>time</name>
      <description>This placeholder lists different epochs in human history and more vague but important timelines such as the future, the present and the past.</description>
    </tag>
    <tag id="2613" parentid="2610" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2016-09-04">
      <name>place</name>
      <description>The places the anime can take place in. Includes more specific places such as a country on Earth, as well as more general places such as a dystopia or a mirror world.</description>
    </tag>
    <tag id="2619" parentid="2841" weight="200" localspoiler="false" globalspoiler="false" verified="true" update="2017-12-26">
      <name>gunfights</name>
      <description>Fights where two or more parties are firing guns at one another.</description>
      <picurl>211280.jpg</picurl>
    </tag>
    <tag id="2626" parentid="2612" weight="600" localspoiler="false" globalspoiler="false" verified="true" update="2009-05-15">
      <name>future</name>
      <description>Anime that fall under the future category are the ones that have a society that could have originated from ours. In most cases it should go hand to hand with sci-fi since we expect the future to consist of advanced technology, however, in the case where it`s explicitly stated in the story that the anime takes place "x years into the future", the state of technology doesn`t matter as long as it`s long into the future. The anime can be set in an alternative universe not tied with our own, as long as it has a futuristic feel to it.
This category sports quite a lot of anime, mostly stemming from SciFi, but not necessarily only from there.</description>
    </tag>
    <tag id="2627" parentid="2613" weight="600" localspoiler="false" globalspoiler="false" verified="true" update="2009-04-20">
      <name>space</name>
      <description>The final frontier.</description>
    </tag>
    <tag id="2636" parentid="2846" weight="200" localspoiler="false" globalspoiler="false" verified="true" update="2015-10-06">
      <name>human enhancement</name>
      <description>The enhancement of humans can take various forms: It can be something comparatively non-intrusive as a power-up drug, a form of machine implantation or cyberization ("SAC Solid State Society"), or outright - possibly atrocious - genetic manipulation ("Ao no 6-gou"). Plot-wise enhanced protagonists in anime usually have to pay a price for their enhancements, be it physical or mental.</description>
    </tag>
    <tag id="2639" parentid="2846" infobox="true" weight="500" localspoiler="false" globalspoiler="false" verified="true" update="2009-04-29">
      <name>space travel</name>
      <description>Space Travel usually refers going to space or travelling there with or without a spacecraft. There are different forms of space travel like Interplanetary travel, Interstellar travel or Intergalactic travel. Since it isn`t possible to travel faster than light, most anime series involve some sort "sub-space travel mechanism" as a way to travel faster than light.</description>
    </tag>
    <tag id="2660" parentid="2627" weight="400" localspoiler="false" globalspoiler="false" verified="true" update="2009-05-15">
      <name>other planet</name>
      <description>The anime will fit this category if some or all of the action takes place on another planet which is supposedly in the same universe as Earth, not a complete fantasy world; usually there has to be some concept of space travel. The Latin name for Earth - Terra, would also pass the condition of being in the same universe as Earth. Basically, even mentioning of Earth existing or having existed would be enough. Although Moon is a moon, it also qualifies as Other Planet.</description>
    </tag>
    <tag id="2661" parentid="2627" weight="400" localspoiler="false" globalspoiler="false" verified="true" update="2009-05-18">
      <name>shipboard</name>
      <description>Beam me up, Scotty! Space stations (think Death Star) also count. Basically, this category is to tell if the setting takes place onboard a spaceship in space. This category is not applicable if the spaceship lies on a planet and never actually gets into space.</description>
    </tag>
    <tag id="2741" parentid="2891" weight="200" localspoiler="false" globalspoiler="false" verified="true" update="2015-12-14">
      <name>large breasts</name>
      <description>Large breasts are breasts a fair notch larger than average, as found in some adolescent girls or fully grown women; however, as anime has no upper limit to breast size, the definition applies somewhat differently. To be considered large, breasts in anime must be bigger than real-life natural ones or natural-seeming fake ones, to the point they`d appear weirdly or even abnormally large in real-life females. On the high end of the spectrum, breasts that are as big as the character`s head or possibly a bit bigger are still considered large; however, breasts that take at least as much space as the rest of the chest or the abdomen, or that are almost as big but have an absurdly unnatural shape, are the less common http://anidb.net/t1774 [gigantic breasts] instead.</description>
      <picurl>161014.jpg</picurl>
    </tag>
    <tag id="2749" parentid="2604" weight="100" localspoiler="false" globalspoiler="false" verified="true" update="2018-07-08">
      <name>nudity</name>
      <description>Nudity is the state of wearing no clothing. The wearing of clothing is exclusively a human characteristic. The amount of clothing worn depends on functional considerations (such as a need for warmth or protection from the elements) and social considerations. In some situations the minimum amount of clothing (i.e. covering of a person`s genitals) may be socially acceptable, while in others much more clothing is expected.
Refer to further guidance on http://wiki.anidb.net/w/Categories:Content_Indicators [the Wiki page] for how to apply tag weights for content indicators.
People, as individuals and in groups, have varying attitudes towards their own nudity. Some people are relaxed about appearing less than fully clothed in front of others, while others are uncomfortable or inhibited in that regard. People are nude in a variety of situations, and whether they are prepared to disrobe in front of others depends on the social context in which the issue arises. For example, people need to bathe without clothing, some people also sleep in the nude, some prefer to sunbathe in the nude or at least topless, while others are nude in other situations. Some people adopt naturism as a lifestyle.
Though the wearing of clothes is the social norm in most cultures, some cultures, groups and individuals are more relaxed about nudity, though attitudes often depend on context. On the other hand, some people feel uncomfortable in the presence of any nudity, and the presence of a nude person in a public place can give rise to controversy, irrespective of the attitude of the person who is nude. Besides meeting social disapproval, in some places public nudity may constitute a crime of indecent exposure. Many people have strong views on nudity, which to them can involve issues and standards of modesty, decency and morality. Some people have an psychological aversion to nudity, called gymnophobia. Many people regard nudity to be inherently sexual and erotic.
Nudity is to be found in a multitude of media, including art, photography, film and on the Internet. It is a factor in adult entertainment of various types.
Especially gratuitous fanservice anime shows tend to show their (usually female) characters frequently without any clothes, though often hiding genitals through the means of additions like steam.
Source: wiki</description>
      <picurl>60576.jpg</picurl>
    </tag>
    <tag id="2778" parentid="2858" weight="300" localspoiler="false" globalspoiler="false" verified="true" update="2012-11-09">
      <name>slow when it comes to love</name>
      <description>The main protagonists in this anime have a very hard time trying to express their feelings to each other. They simply will not finally confess their love.
In some cases this romance element is based on unrequited love, or an absurd amount of shyness.</description>
    </tag>
    <tag id="2790" parentid="2605" weight="600" localspoiler="false" globalspoiler="false" verified="true" update="2010-01-17">
      <name>plot continuity</name>
      <description>Consistency of the characteristics of persons, plot, objects, places and events seen by the viewer.
A single linear focused plot is highly continuous.
A truly random plot is highly discontinuous.</description>
    </tag>
    <tag id="2799" parentid="2609" infobox="true" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2010-05-14">
      <name>novel</name>
      <description>Note that novel means book with words in paper, so no comics and no "visual novels", which should go under manga and dating-sim - visual Novel/erotic game respectively.
Note that it can be applied to novels as we know them but also the typical light novels for teens and young adults, which are common in Japan and aside from being short include a number of illustrations.</description>
    </tag>
    <tag id="2841" parentid="2611" infobox="true" weight="400" localspoiler="false" globalspoiler="false" verified="true" update="2017-12-26">
      <name>action</name>
      <description>Action anime usually involve a fairly straightforward story of good guys versus bad guys, where most disputes are resolved by using physical force. It often contains a lot of shooting, explosions and fighting.</description>
      <picurl>211261.jpg</picurl>
    </tag>
    <tag id="2846" parentid="7050" infobox="true" weight="500" localspoiler="false" globalspoiler="false" verified="true" update="2018-01-21">
      <name>science fiction</name>
      <description>Science fiction stories usually focus on how situations could be different in the future when we are more technologically advanced; due to either our own achievements or having met with other civilizations whom we have learned from.</description>
      <picurl>212180.jpg</picurl>
    </tag>
    <tag id="2849" parentid="7050" weight="100" localspoiler="false" globalspoiler="false" verified="true" update="2005-05-07">
      <name>fantasy</name>
      <description>Fantasy is a genre of fiction that uses magic and other supernatural phenomena as a primary element of plot, theme, or setting. Many works within the genre take place in fictional worlds where magic is common. Fantasy is generally distinguished from science fiction and horror by the expectation that it steers clear of (pseudo-)scientific and macabre themes, respectively, though there is a great deal of overlap between the three (which are subgenres of speculative fiction).
In popular culture, the genre of fantasy is dominated by its medievalist form, especially since the worldwide success of The Lord of the Rings books by J. R. R. Tolkien. In its broadest sense however, fantasy comprises works by many writers, artists, filmmakers, and musicians, from ancient myths and legends to many recent works embraced by a wide audience today.
Fantasy is a vibrant area of academic study in a number of disciplines (English, cultural studies, comparative literature, history, medieval studies). Work in this area ranges widely, from the structuralist theory of Tzvetan Todorov, which emphasizes the fantastic as a liminal space, to work on the connections (political, historical, literary) between medievalism and popular culture
Source: Wiki</description>
      <picurl>68768.jpg</picurl>
    </tag>
    <tag id="2850" parentid="2611" infobox="true" weight="500" localspoiler="false" globalspoiler="false" verified="true" update="2015-10-25">
      <name>adventure</name>
      <description>Adventures are exciting stories, with new experiences or exotic locales. Adventures are designed to provide an action-filled, energetic experience for the viewer. Rather than the predominant emphasis on violence and fighting that is found in pure action anime, however, the viewer of adventures can live vicariously through the travels, conquests, explorations, creation of empires, struggles and situations that confront the main characters, actual historical figures or protagonists. Under the category of adventures, we can include traditional swashbucklers, serialized films, and historical spectacles, searches or expeditions for lost continents, "jungle" and "desert" epics, treasure hunts and quests, disaster films, and heroic journeys or searches for the unknown. Adventure films are often, but not always, set in an historical period, and may include adapted stories of historical or literary adventure heroes, kings, battles, rebellion, or piracy.</description>
      <picurl>178879.jpg</picurl>
    </tag>
    <tag id="2858" parentid="2611" weight="300" localspoiler="false" globalspoiler="false" verified="true" update="2017-12-01">
      <name>romance</name>
      <description>Romance describes a story that deals with love between two or more characters typically also having an optimistic ending. Romance is also a difficulty encountered when creating a harem.</description>
      <picurl>210061.jpg</picurl>
    </tag>
    <tag id="2868" parentid="2607" weight="200" localspoiler="false" globalspoiler="false" verified="true" update="2015-12-20">
      <name>racism</name>
      <description>Racism is prejudice, discrimination, or antagonism directed against someone of an ethnically different background based on the pseudo-scientific belief that biological differences between peoples form so-called "races" and that one`s own "race" is superior to another, possibly also holding that members of different "races" should be treated differently. Some definitions include only consciously malignant forms of discrimination, and some views include discriminatory behaviors and beliefs based on cultural, national, ethnic, caste, or religious stereotypes. In works of fiction, this may also include similar actions against other sentient species.
Source: Wikipedia</description>
    </tag>
    <tag id="2874" parentid="2607" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2018-05-07">
      <name>disaster</name>
      <description>A disaster is a large-scale situation that causes great loss of or damage or threat to life, health, property, society, or the environment, irrespective of its source or cause. Disasters have substantial, long-lasting negative repercussions, and great effort must be spent in order to undo or mitigate their effects.</description>
    </tag>
    <tag id="2891" parentid="2608" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2014-12-31">
      <name>breasts</name>
      <description>The female bust size matters! Or does it? The three subcategories spell out the sizes that relate to fetishes, be they gigantic, large or small. Normal sized breasts are not a fetish, it seems. The tag is not only used for ecchi anime, but also for hentai shows as well.</description>
      <picurl>161015.jpg</picurl>
    </tag>
    <tag id="2907" parentid="2636" infobox="true" weight="400" localspoiler="false" globalspoiler="false" verified="true" update="2015-09-24">
      <name>genetic modification</name>
      <description>Story-wise, genetic modification is usually centred on humans, probably the most subtle and creepy way of messing with mankind. Playing with the fear of the unknown, genetically altered humans are technically a new species, that may not only surpass but actually replace unaltered humans. The level of modification will vary from subtle changes in "look" (e.g. super-human beauty), to mental enhancements (PSI powers), to more or less atrocious adaptations to extreme environments (breath under water, radiation resistance). Note that changes in Aliens would be difficult to pinpoint, after all they are alien.</description>
    </tag>
    <tag id="2925" parentid="2874" weight="400" localspoiler="false" globalspoiler="false" verified="true" update="2012-10-07">
      <name>war</name>
      <description>War is a phenomenon of organized violent conflict, typified by extreme aggression, societal disruption and adaptation, and high mortality. The objective of warfare differs in accord with a group`s role in a conflict: The goals of offensive warfare are typically the submission, assimilation or destruction of another group, while the goals of defensive warfare are simply the repulsion of the offensive force and, often, survival itself. Relative to each other, combatants in warfare are called enemies. The terms military, militant, and militarism each refer to fundamental aspects of war, i.e. the organized group, the combative individual, and the supportive ethos (respectively).
Source: wiki</description>
      <picurl>56441.jpg</picurl>
    </tag>
    <tag id="3138" parentid="6151" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2014-10-08">
      <name>fictional language</name>
      <description>Fictional languages are intended to be the languages of a fictional world and are often designed with the intent of giving more depth and an appearance of plausibility to the fictional worlds with which they are associated, and to have their characters communicate in a fashion which is both alien and dislocated.
Some of these languages, e.g. in worlds of fantasy fiction, alternative universes, Earth`s future, or alternate history, are presented as distorted versions or dialects of modern English or other natural language, while others are independently designed conlangs.
A fictional language often has the least amount of grammar and vocabulary possible, and rarely extends beyond the absolutely necessary. At the same time, some others have developed languages in detail for their own sake, such as J. R. R. Tolkien`s Quenya and Sindarin and Star Trek`s Klingon language which exist as functioning, usable languages. Here "fictional" can be a misnomer.</description>
    </tag>
    <tag id="3489" parentid="2841" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2017-12-26">
      <name>car chases</name>
      <description>Car chases occur as part of the action setting in this anime.</description>
      <picurl>211263.jpg</picurl>
    </tag>
    <tag id="3589" parentid="6230" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2011-03-06">
      <name>multiple protagonists</name>
    </tag>
    <tag id="3683" parentid="2605" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2014-09-28">
      <name>storytelling</name>
    </tag>
    <tag id="3929" parentid="2607" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2016-09-09">
      <name>sociocultural evolution</name>
      <description>Describes how cultures and societies develop over time, based on both cultural evolution and social evolution.
A post-apocalyptic or a Utopian setting would show very interesting changes in human behaviour, mental state, or simply daily life.</description>
      <picurl>191062.jpg</picurl>
    </tag>
    <tag id="3977" parentid="3683" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2008-12-29">
      <name>dialogue driven</name>
      <description>A dialogue driven show has its story advanced by dialogue, with action being of much lower priority, and relies heavily on conversations between characters.</description>
    </tag>
    <tag id="4022" parentid="6230" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2010-11-29">
      <name>strong female lead</name>
      <description>The lead female character has a strong personality and plays a part that is not the typical damsel-in-distress role.
This is the exact opposite of the &#x201C;damsel in distress&#x201D; tag.</description>
    </tag>
    <tag id="4081" parentid="2841" weight="400" localspoiler="false" globalspoiler="false" verified="true" update="2008-06-02">
      <name>space battles</name>
      <description>There are space battles in this anime. Usually between Earth forces and some alien invader, but ship to ship skirmishes in deep space are just as common.</description>
    </tag>
    <tag id="4440" parentid="2858" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2010-02-01">
      <name>boy meets girl</name>
      <description>A classical type of plot in story writing, where the story begins with a boy meeting a girl leading to romantic development between the two. More often than not the boy loses the girl later on and has to find her again.</description>
    </tag>
    <tag id="4446" parentid="2639" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2017-12-12">
      <name>faster-than-light travel</name>
      <description>Faster-than-light travel is taken for grated in this anime. This is achieved by travelling via hyperspace, nullspace, or wormholes.</description>
    </tag>
    <tag id="4480" parentid="6246" weight="0" localspoiler="false" globalspoiler="true" verified="true" update="2018-08-13">
      <name>happy ending</name>
      <description>And they lived "happily ever after"... *sniff*.
All issues in the anime have been resolved, the love polygons sorted out, the conflicts resolved, the guy gets the girl (or the other way around), and everyone else lives on blissfully.
(Not very realistic, but then again this is anime.)</description>
      <picurl>222185.jpg</picurl>
    </tag>
    <tag id="4537" parentid="2605" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2014-02-15">
      <name>time skip</name>
      <description>The plot features at least one skip or jump in time.
Example: A skip from the present into the past, or time skips in increments, e.g. every hour there is a time skip by a day.</description>
    </tag>
    <tag id="4665" parentid="2607" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2015-02-26">
      <name>propaganda</name>
      <description>Propaganda is communication aimed at influencing the attitude of a community toward some cause or position. As opposed to impartially providing information, propaganda in its most basic sense, presents information primarily to influence an audience. Propaganda often presents facts selectively (thus lying by omission) to encourage a particular synthesis, or uses loaded messages to produce an emotional rather than rational response to the information presented. The desired result is a change of the attitude toward the subject in the target audience to further a political agenda.</description>
    </tag>
    <tag id="5003" parentid="2607" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2015-12-10">
      <name>imperialism</name>
      <description>Imperialism is a type of advocacy of empire. Its name originated from the Latin word "imperium", which means to rule over large territories. Imperialism is "a policy of extending a country`s power and influence through colonization, use of military force, or other means".
Source: Wiki</description>
    </tag>
    <tag id="5929" parentid="2846" weight="400" localspoiler="false" globalspoiler="false" verified="true" update="2014-09-10">
      <name>space opera</name>
      <description>Space opera is a sub-genre of fiction that emphasizes romantic adventures in space. Space opera generally involves large-scale conflicts between opponents with powerful abilities and technology. The genre will often be melodramatic, sometimes playing music that can be nothing short of awesome. Warfare and a battle of wits are usually less emphasized, preferring romance (with exceptions, e.g. Ginga Eiyuu Densetsu). Some space operas tend to be formulaic and sometimes even prosaic, often employing very simple devices and somewhat obvious strategies. An example of this would be the infamous laws of physics in the Macross universe, in which the main male lead will hardly ever get hit in battle.</description>
    </tag>
    <tag id="6151" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2014-09-10">
      <name>technical aspects</name>
      <description>It may sometimes be useful to know about technical aspects of a show, such as information about its broadcasting or censorship. Such information can be found here.</description>
    </tag>
    <tag id="6230" parentid="2605" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2014-10-20">
      <name>cast</name>
    </tag>
    <tag id="6246" parentid="2605" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2018-08-06">
      <name>ending</name>
      <description>This is a container tag to house meta-like tags relating to how endings of anime play out.</description>
    </tag>
    <tag id="7050" parentid="2611" weight="0" localspoiler="false" globalspoiler="false" verified="true" update="2018-01-02">
      <name>speculative fiction</name>
    </tag>
  </tags>
  <characters>
    <character id="28" type="main character in" update="2012-07-25">
      <rating votes="1196">9.15</rating>
      <name>Abriel Nei Debrusc Borl Paryun Lafiel</name>
      <gender>female</gender>
      <charactertype id="1">Character</charactertype>
      <description>Abl&#xEF;arsec n&#xE9;&#xEF;c Dubreuscr B&#x153;rh Parhynr Lamhirh (a.k.a., Viscountess Paryunu Abriel Nei Dobrusk Lafiel) is the main female protagonist in the anime Crest of the Stars, Banner of the Stars, and Banner of the Stars II, as well as all the novels written by Morioka Hiroyuki on which the shows were based. She is a strong-willed Abh princess (granddaughter of the Abh empress) who has a steely exterior, but ends up befriending Ghintec Linn (Jinto Lynn in the Martinh tongue). Like all Abh, she has bluish hued hair, and has a natural lifespan of over 200 years. Lamhirh also has lapis lazuli colored eyes. As an Abl&#xEF;arsec, she has pointed ears, yet hers are markedly less so than other Abl&#xEF;arsec. This is because half her genes (those not from her father) are from someone outside the Abriel clan and her father chose not to make any unnecessary alterations in her genes. She is deemed "child of love" (an Abh child with the genes of the parent, and the one the parent loves). Her full name can be roughly translated to Lamhirh (n&#xE9;&#xEF;c Dubleuscr) Abl&#xEF;arsec, Viscountess of Parhyn.
Despite being a princess, she rarely acts like one and hates being treated as one. One of the reasons she took a liking towards Ghintec is because when they first met, he neither recognized her as a princess nor treated her as one. Their relationship is so close that she freely allows him to use her real name of Lamhirh when addressing her, something that is very uncommon when addressing those of nobility or royalty.
She acts remarkably older than her age (at her introduction in Crest of the Stars, she is 16 years old) and can, in most cases, logically think her way out of most situations. However, her headstrong nature sometimes clouds her judgement and can lead her to become impulsive. An example of this is when she is reprimanded by Laicch for wishing to stay behind on the Gothlauth instead of continuing her mission of escorting Ghintec to the capital. She believes that she would have been of more use fighting with the crew rather than abandoning them. She is quickly shown how wrong her line of reasoning is and how much more disgraceful it would have been to abandon Ghintec and her mission. She is a remarkably good shot and although she sometimes doubts herself, she proves to be a worthy ship captain (deca-commander) in Banner of the Stars. She shows little emotion throughout Crest of the Stars, but as time goes by became very close friend with Ghintec through Banner of the Stars. This is especially true in later installments, where she more frequently questions how their friendship will last due to the doubt of Ghintec`s lifespan.
She is one of the candidates for the Abh Imperial Throne and, as indicated by her full name, she is the Viscountess of Parhynh, the so-called "Country, or Nation, of Roses."</description>
      <picture>14304.jpg</picture>
      <seiyuu id="12" picture="184301.jpg">Kawasumi Ayako</seiyuu>
    </character>
    <character id="4079" type="secondary cast in" update="2009-02-28">
      <rating votes="19">6.17</rating>
      <name>Abriel Nei Debrusc Larth Kryb Debeus</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <description>Lafiel`s father, the King of Kryv and a son of the current reigning empress.</description>
      <picture>20037.jpg</picture>
      <seiyuu id="3136" picture="24121.jpg">Suzuoki Hirotaka</seiyuu>
    </character>
    <character id="4080" type="secondary cast in" update="2009-02-28">
      <rating votes="30">8.79</rating>
      <name>Lexshu Wef-Robell Plakia</name>
      <gender>female</gender>
      <charactertype id="1">Character</charactertype>
      <description>The captain of the Gosroth (Gothlauth), she is every bit as smart, beautiful, dedicated and stubborn as Lafiel, but older and wiser. Judging from her name, Lexshu`s rank in the Abh social hierarchy is that of a reucec (knight or dame).</description>
      <picture>20038.jpg</picture>
      <seiyuu id="404" picture="151682.jpg">Takashima Gara</seiyuu>
    </character>
    <character id="4081" type="main character in" update="2012-07-25">
      <rating votes="210">7.52</rating>
      <name>Linn Syun-Rock Dreu Haider Jinto</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <description>Born Jinto Lynn on planet Martine (spelt as Martinh in Baronh) of the Hyde star system (Ha&#xEF;dec in Baronh), he was the son of Rock Lynn, a politician who eventually became president of the Hyde star system. It was during his administration that the Abh empire was able to annex the Hyde stellar system into its territory through an invasion. Making his own ideas more valuable than the rights of the people of Martine, Rock Lin made a deal with the leaders of the invading forces that the territorial lord of Hyde shall be chosen amongst the people of Martine. The leader of the invading forces agreed to this however this meant that an election cannot be held making Rock, as the current leader of Martine, the natural choice to become its territorial lord. Because of this, Rock Lynn, and with him, Jinto, rose to the ranks of Abh nobility as Count of Ha&#xEF;dec.</description>
      <picture>20036.jpg</picture>
      <seiyuu id="362" picture="74735.jpg">Imai Yuka</seiyuu>
    </character>
    <character id="4082" type="secondary cast in" update="2009-02-28">
      <rating votes="63">8.71</rating>
      <name>Abriel Nei Lamsar Larth Balkei Dusanyu</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <description>The current Dusanyu, or Crown Prince, of the Abh Empire of Mankind, the Baronh name of which is Frybar Gloer Gor Bari (Frybarec Gloer Gor Bari), Also the Commander-in-Chief of the Abh Armed Forces, who personally led the invasion of the Hyde star system.</description>
      <picture>20035.jpg</picture>
      <seiyuu id="1819" picture="20694.jpg">Shiozawa Kaneto</seiyuu>
    </character>
    <character id="4083" type="secondary cast in" update="2009-02-28">
      <rating votes="19">6.69</rating>
      <name>Trife Boli Yuvdale Remsale</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <description>Despite verging on excessive caution, he is nonetheless one of the most able tacticians in the Labule. He puts every aspect and factor under consideration, frequently asking his subordinates` opinions and assessments before starting an operation. He is also one of the least loved officers.</description>
      <picture>20034.jpg</picture>
      <seiyuu id="220" picture="17038.jpg">Kosugi Juurouta</seiyuu>
    </character>
    <character id="4084" type="secondary cast in" update="2009-02-28">
      <rating votes="224">9.08</rating>
      <name>Spoor Aron Sekpadao Letopanyu Peneju</name>
      <gender>female</gender>
      <charactertype id="1">Character</charactertype>
      <description>This red-eyed Grand Duchess is one of the most eccentric officers in the Labule, which does not change the fact that she is one of its most able admirals. Though complaining of boredom most of the time, she suddenly springs into action when needed. One of her favourite pastimes is mercilessly teasing Kaselia, her chief of staff.</description>
      <picture>20033.jpg</picture>
      <seiyuu id="1509" picture="19311.jpg">Fukami Rika</seiyuu>
    </character>
    <character id="4085" type="secondary cast in" update="2009-02-28">
      <rating votes="16">2.84</rating>
      <name>Atosryua Syun-Atos Lyuf Raika Febdak Klowal</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <description>The third Baron of Febdak (Faibdash), an obscure star system where Jinto and Lafiel made a stopover en route to Safugnoff (Sfagnaumh). He had an inferiority complex due to his clan`s origins and brief history, causing him to confine and isolate his own father. He tried to abduct Lafiel and imprison Jinto, which brought dire consequences onto himself.</description>
      <picture>20032.jpg</picture>
      <seiyuu id="139" picture="29283.jpg">Koyasu Takehito</seiyuu>
    </character>
    <character id="4086" type="secondary cast in" update="2009-02-28">
      <rating votes="16">6.64</rating>
      <name>Atosryua Syun-Atos Lyuf Raika Febdak Srguf</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <description>The second Baron of Febdak and father of Klowal. Srguf`s mother was the first Baroness, who gained distinction by rising through the Imperial Star Force, or Labule (Laburec). Due to his being a genetic "grounder," his own son despised him resulting in confinement and isolation. He eventually befriended Jinto and aided Lafiel in "punishing" Klowal. His daughter, Lo&#xEF;c eventually became the Baroness of Febdak and a commanding officer to Lafiel and Jinto.</description>
      <picture>20039.jpg</picture>
      <seiyuu id="39" picture="16629.jpg">Mugihito</seiyuu>
    </character>
    <character id="4087" type="appears in" update="2009-02-28">
      <rating votes="5">5.33</rating>
      <name>Entoryua Rei</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <picture>20044.jpg</picture>
      <seiyuu id="339" picture="79312.jpg">Ishizuka Unshou</seiyuu>
    </character>
    <character id="4088" type="secondary cast in" update="2009-02-28">
      <rating votes="6">1.41</rating>
      <name>Kaito</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <picture>20045.jpg</picture>
      <seiyuu id="3312" picture="24691.jpg">Ikemizu Michihiro</seiyuu>
    </character>
    <character id="7493" type="appears in" update="2010-12-03">
      <rating votes="2">6.14</rating>
      <name>Gosroth</name>
      <gender>unknown</gender>
      <charactertype id="4">Vessel</charactertype>
      <description>The Resii Gothroth.
The first Abh ship lost in the war.</description>
      <picture>60215.jpg</picture>
    </character>
    <character id="7501" type="appears in" update="2014-02-15">
      <rating votes="1">3.80</rating>
      <name>Wakusei Martine</name>
      <gender>unknown</gender>
      <charactertype id="3">Organization</charactertype>
      <description>The homeworld of Jinto</description>
      <picture>150280.jpg</picture>
    </character>
    <character id="7503" type="appears in" update="2009-05-27">
      <rating votes="2">3.35</rating>
      <name>Rock Lynn</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <description>The former president of Martine, later made count of the Hyde system, after striking a deal with the Abh (in episode 1)</description>
      <picture>26165.jpg</picture>
      <seiyuu id="1733" picture="25839.jpg">Tanaka Hideyuki</seiyuu>
    </character>
    <character id="7512" type="secondary cast in" update="2009-05-27">
      <rating votes="5">2.98</rating>
      <name>Jinto Lynn</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <description>Jinto, before he became a noble of the Abh.</description>
      <picture>26167.jpg</picture>
    </character>
    <character id="7514" type="appears in" update="2009-05-27">
      <rating votes="12">8.15</rating>
      <name>Abh Teikoku</name>
      <gender>unknown</gender>
      <charactertype id="3">Organization</charactertype>
      <picture>26171.jpg</picture>
    </character>
    <character id="7516" type="appears in" update="2009-05-27">
      <rating votes="3">1.92</rating>
      <name>Till Corinth</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <picture>26175.jpg</picture>
      <seiyuu id="4193" picture="154158.jpg">Suzuki Eiichirou</seiyuu>
    </character>
    <character id="21911" type="appears in" update="2010-09-27">
      <rating votes="5">5.54</rating>
      <name>Lina Clint</name>
      <gender>female</gender>
      <charactertype id="1">Character</charactertype>
      <picture>55529.jpg</picture>
      <seiyuu id="4708" picture="94172.jpg">Hosono Masayo</seiyuu>
    </character>
    <character id="21943" type="secondary cast in" update="2010-09-28">
      <rating votes="8">5.97</rating>
      <name>Ku Dorin</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <picture>55561.jpg</picture>
      <seiyuu id="2799" picture="23198.jpg">Matsuno Taiki</seiyuu>
    </character>
    <character id="21944" type="secondary cast in" update="2010-09-28">
      <rating votes="3">4.80</rating>
      <name>Gyumuryua</name>
      <gender>female</gender>
      <charactertype id="1">Character</charactertype>
      <picture>55562.jpg</picture>
      <seiyuu id="17008" picture="46192.jpg">Fuji Takako</seiyuu>
    </character>
    <character id="21945" type="secondary cast in" update="2010-09-28">
      <rating votes="2">7.15</rating>
      <name>Deesh</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <picture>55563.jpg</picture>
      <seiyuu id="1913" picture="186187.jpg">Chiba Isshin</seiyuu>
    </character>
    <character id="21946" type="secondary cast in" update="2010-09-28">
      <rating votes="2">5.14</rating>
      <name>Lairia</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <picture>55564.jpg</picture>
      <seiyuu id="370" picture="204461.jpg">Yusa Kouji</seiyuu>
    </character>
    <character id="21947" type="secondary cast in" update="2010-09-28">
      <rating votes="2">6.16</rating>
      <name>Leshikuna</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <picture>55566.jpg</picture>
      <seiyuu id="2899" picture="79024.jpg">Miyazaki Issei</seiyuu>
    </character>
    <character id="21948" type="secondary cast in" update="2010-09-28">
      <rating votes="2">4.19</rating>
      <name>Saryush</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <picture>55567.jpg</picture>
      <seiyuu id="399" picture="17244.jpg">Suyama Akio</seiyuu>
    </character>
    <character id="21949" type="secondary cast in" update="2010-09-28">
      <rating votes="3">4.80</rating>
      <name>Yunseryua</name>
      <gender>female</gender>
      <charactertype id="1">Character</charactertype>
      <picture>55568.jpg</picture>
      <seiyuu id="21499" picture="188514.jpg">Tomokawa Mari</seiyuu>
    </character>
    <character id="21954" type="secondary cast in" update="2011-04-08">
      <rating votes="7">5.38</rating>
      <name>Abriel Nei Debrusc Spunej Ramaj</name>
      <gender>female</gender>
      <charactertype id="1">Character</charactertype>
      <description>The 37th and current reigning empress of the Abh Empire, she is also Lafiel`s grandmother. She also holds the title "Dreuc Abl&#xEF;arser" (Countess of Abl&#xEF;arsec; Abl&#xEF;arsec is also the name of the stellar system where Lakfakalle (Lacmhacarh), the imperial capital, is located).</description>
      <picture>55576.jpg</picture>
      <seiyuu id="542" picture="60897.jpg">Doi Mika</seiyuu>
    </character>
    <character id="21958" type="appears in" update="2015-02-07">
      <rating votes="3">8.05</rating>
      <name>Futune</name>
      <gender>none/does not apply</gender>
      <charactertype id="4">Vessel</charactertype>
      <picture>55580.jpg</picture>
    </character>
    <character id="40209" type="appears in" update="2012-01-04">
      <rating votes="15">5.34</rating>
      <name>Diaho</name>
      <gender>male</gender>
      <charactertype id="1">Character</charactertype>
      <description>Jinto`s cat.
 
Lafiel gave him to Jinto at the end of http://anidb.net/a1 [Seikai no Monshou].
He is the son of Zanelia who is the daughter of Holia.
</description>
      <picture>79471.jpg</picture>
    </character>
    <character id="49519" type="appears in" update="2012-09-30">
      <rating votes="2">2.49</rating>
      <name>Seelnay</name>
      <gender>female</gender>
      <charactertype id="1">Character</charactertype>
      <picture>50186.jpg</picture>
      <seiyuu id="7" picture="186500.jpg">Ootani Ikue</seiyuu>
    </character>
  </characters>
  <episodes>
    <episode id="1" update="2011-07-01">
      <epno type="1">1</epno>
      <length>25</length>
      <airdate>1999-01-03</airdate>
      <rating votes="28">3.31</rating>
      <title xml:lang="ja">&#x4FB5;&#x7565;</title>
      <title xml:lang="en">Invasion</title>
      <title xml:lang="fr">Invasion</title>
      <title xml:lang="x-jat">Shinryaku</title>
    </episode>
    <episode id="2" update="2011-07-01">
      <epno type="1">2</epno>
      <length>25</length>
      <airdate>1999-01-10</airdate>
      <rating votes="22">4.94</rating>
      <title xml:lang="ja">&#x661F;&#x305F;&#x3061;&#x306E;&#x7737;&#x65CF;</title>
      <title xml:lang="en">Kin of the Stars</title>
      <title xml:lang="fr">Les parents des &#xC9;toiles</title>
      <title xml:lang="x-jat">Hoshi-tachi no Kenzoku</title>
    </episode>
    <episode id="1009" update="2011-07-01">
      <epno type="1">10</epno>
      <length>25</length>
      <airdate>1999-03-07</airdate>
      <rating votes="17">6.86</rating>
      <title xml:lang="ja">&#x4E8C;&#x4EBA;&#x3060;&#x3051;&#x306E;&#x9003;&#x4EA1;</title>
      <title xml:lang="en">Escape: Just the Two of Us</title>
      <title xml:lang="fr">Fuite &#xE0; deux</title>
      <title xml:lang="x-jat">Futari dake no Toubou</title>
    </episode>
    <episode id="1010" update="2011-07-01">
      <epno type="1">5</epno>
      <length>25</length>
      <airdate>1999-01-31</airdate>
      <rating votes="20">8.06</rating>
      <title xml:lang="ja">&#x30B4;&#x30FC;&#x30B9;&#x30ED;&#x30B9;&#x306E;&#x6226;&#x3044;</title>
      <title xml:lang="en">The Battle of Gosroth</title>
      <title xml:lang="fr">La bataille du Gothlauth</title>
      <title xml:lang="x-jat">Gosroth no Tatakai</title>
    </episode>
    <episode id="1011" update="2011-07-01">
      <epno type="1">4</epno>
      <length>25</length>
      <airdate>1999-01-24</airdate>
      <rating votes="20">7.19</rating>
      <title xml:lang="ja">&#x5947;&#x8972;</title>
      <title xml:lang="en">Surprise Attack</title>
      <title xml:lang="fr">Attaque surprise</title>
      <title xml:lang="x-jat">Kishuu</title>
    </episode>
    <episode id="1012" update="2011-07-01">
      <epno type="1">3</epno>
      <length>25</length>
      <airdate>1999-01-17</airdate>
      <rating votes="19">7.31</rating>
      <title xml:lang="ja">&#x611B;&#x306E;&#x5A18;</title>
      <title xml:lang="en">Daughter of Love</title>
      <title xml:lang="fr">La fille d`Amour</title>
      <title xml:lang="x-jat">Ai no Musume</title>
    </episode>
    <episode id="1013" update="2011-07-01">
      <epno type="1">9</epno>
      <length>25</length>
      <airdate>1999-02-28</airdate>
      <rating votes="17">6.84</rating>
      <title xml:lang="ja">&#x6226;&#x5834;&#x3078;</title>
      <title xml:lang="en">To the Battlefield</title>
      <title xml:lang="fr">Vers le champ de bataille</title>
      <title xml:lang="x-jat">Senjou e</title>
    </episode>
    <episode id="1014" update="2011-07-01">
      <epno type="1">13</epno>
      <length>40</length>
      <airdate>1999-03-28</airdate>
      <rating votes="16">8.53</rating>
      <title xml:lang="ja">&#x5929;&#x7FD4;&#x308B;&#x8FF7;&#x60D1;</title>
      <title xml:lang="en">Trouble Soaring Through Heaven</title>
      <title xml:lang="fr">Des g&#xEA;neurs dans le firmament</title>
      <title xml:lang="x-jat">Amagakeru Meiwaku</title>
    </episode>
    <episode id="1015" update="2011-07-01">
      <epno type="1">8</epno>
      <length>25</length>
      <airdate>1999-02-21</airdate>
      <rating votes="17">7.19</rating>
      <title xml:lang="ja">&#x30A2;&#x30FC;&#x30F4;&#x306E;&#x6D41;&#x5100;</title>
      <title xml:lang="en">The Style of the Abh</title>
      <title xml:lang="fr">La m&#xE9;thode Abh</title>
      <title xml:lang="x-jat">Abh no Ryuugi</title>
    </episode>
    <episode id="1016" update="2011-07-01">
      <epno type="1">12</epno>
      <length>25</length>
      <airdate>1999-03-21</airdate>
      <rating votes="17">6.67</rating>
      <title xml:lang="ja">&#x60D1;&#x4E71;&#x306E;&#x6DD1;&#x5973;</title>
      <title xml:lang="en">Lady of Chaos</title>
      <title xml:lang="fr">La Dame du Chaos</title>
      <title xml:lang="x-jat">Wakuran no Shukujo</title>
    </episode>
    <episode id="1017" update="2011-07-01">
      <epno type="1">7</epno>
      <length>25</length>
      <airdate>1999-02-14</airdate>
      <rating votes="17">6.93</rating>
      <title xml:lang="ja">&#x5E78;&#x305B;&#x306A;&#x53DB;&#x9006;</title>
      <title xml:lang="en">Fortunate Revolt</title>
      <title xml:lang="fr">Heureuse r&#xE9;volte</title>
      <title xml:lang="x-jat">Shiawase na Hangyaku</title>
    </episode>
    <episode id="1018" update="2011-07-01">
      <epno type="1">11</epno>
      <length>25</length>
      <airdate>1999-03-14</airdate>
      <rating votes="18">6.00</rating>
      <title xml:lang="ja">&#x30B9;&#x30D5;&#x30A1;&#x30B0;&#x30CE;&#x30FC;&#x30D5;&#x9580;&#x6C96;&#x4F1A;&#x6226;</title>
      <title xml:lang="en">Sufugnoff Gateway Battle</title>
      <title xml:lang="fr">La bataille du portail de Sfagnaumh</title>
      <title xml:lang="x-jat">Sufugnoff Mon Oki Kaisen</title>
    </episode>
    <episode id="1019" update="2011-07-01">
      <epno type="1">6</epno>
      <length>25</length>
      <airdate>1999-02-07</airdate>
      <rating votes="17">6.61</rating>
      <title xml:lang="ja">&#x4E0D;&#x53EF;&#x89E3;&#x306A;&#x9670;&#x8B00;</title>
      <title xml:lang="en">Mysterious Conspiracy</title>
      <title xml:lang="fr">Myst&#xE9;rieuses intrigues</title>
      <title xml:lang="x-jat">Fukakai na Inbou</title>
    </episode>
    <episode id="120767" update="2010-08-05">
      <epno type="3">C3</epno>
      <length>0</length>
      <rating votes="1">3.80</rating>
      <title xml:lang="en">Ending 2</title>
    </episode>
    <episode id="120768" update="2010-08-05">
      <epno type="3">C2</epno>
      <length>0</length>
      <rating votes="1">5.69</rating>
      <title xml:lang="en">Ending 1</title>
    </episode>
    <episode id="120769" update="2010-08-05">
      <epno type="3">C1</epno>
      <length>0</length>
      <rating votes="1">3.80</rating>
      <title xml:lang="en">Opening</title>
    </episode>
  </episodes>
</anime>
</pre>
 
==== Errors ====
[http://anidb.net/perl-bin/animedb.pl?show=cmt&post=159118 According to ommina] the API does not use HTTP return code. Instead you will get XML consisting of one tag with a textual description.
<pre>
<error>Banned</error>
</pre>
 
=== Random Recommendation ===
 
This command mirrors the type of data provided on the main web page.  Use this instead of scraping the HTML.  Please note, however, that the 'random recommendations' are, in fact, random.  Please do not expect random results here to match random results there.


* clientver={integer} [required]
==== Access ====
** client version number, needs to be valid client version number for the given client identification string.
Base URL: <u><nowiki>http://api.anidb.net:9001/httpapi?request=randomrecommendation</nowiki></u>


Parameters:
* <tt>request=randomrecommendation</tt>


Example:
Example:
URL: http://.../animedb.pl?show=xmlapi&client=clientname&clienver=13&...
URL: <u><nowiki>http://api.anidb.net:9001/httpapi?client={str}&clientver={int}&protover=1&request=randomrecommendation</nowiki></u>
 
<pre>
<randomrecommendation>
    <recommendation>
        <anime id="7899" restricted="false">
            <type>TV Series</type>
            <episodecount>13</episodecount>
            <startdate>2010-10-04</startdate>
            <enddate>2010-12-27</enddate>
            <title xml:lang="x-jat" type="main">Arakawa Under the Bridge 2</title>
            <picture>54734.jpg</picture>
            <ratings>
                <permanent count="781">623</permanent>
                <recommendations>8</recommendations>
            </ratings>
        </anime>
    </recommendation>
 
...


= Anime Search =
<randomrecommendation>
</pre>


Allows lookup of AniDB anime ids (AIDs) by anime title. Additionally AniDB also provides a daily dump with all anime titles which can be used to implement client-side searches, see: [[API]].
=== Random Similar ===


== Access ==
This command mirrors the type of data provided on the main web page.  Use this instead of scraping the HTML.  Please note, however, that the 'random similar' are, in fact, random.  Please do not expect random results here to match random results there.


Base URL: TBA
==== Access ====
Base URL: <u><nowiki>http://api.anidb.net:9001/httpapi?request=randomsimilar</nowiki></u>


Parameters:
Parameters:
* query={string} [required]
* <tt>request=randomsimilar</tt>
** the query string to search for.


Example:
Example:
URL: http://.../animedb.pl?show=xmlapi&...&t=search&query=sometitle
URL: <u><nowiki>http://api.anidb.net:9001/httpapi?client={str}&clientver={int}&protover=1&request=randomsimilar</nowiki></u>
 
<pre>
<randomsimilar>
    <similar>
        <source aid="7056" restricted="false">
            <title xml:lang="x-jat" type="main">Aoi Bungaku Series</title>
            <picture>37124.jpg</picture>
        </source>
        <target aid="3654" restricted="false">
            <title xml:lang="x-jat" type="main">Ayakashi: Japanese Classic Horror</title>
            <picture>44085.jpg</picture>
        </target>
    </similar>
 
...
 
</randomsimilar>
</pre>
 
=== Hot Anime ===
 
This command mirrors the type of data provided on the main web page.  Use this instead of scraping the HTML.  Unlike the two random result commands, the results here will match the results as supplied by the main web page (with some possible variance of a few hours, depending on cache life.)
 
==== Access ====
Base URL: <u><nowiki>http://api.anidb.net:9001/httpapi?request=hotanime</nowiki></u>
 
Parameters:
* <tt>request=hotanime</tt>


Example:
URL: <u><nowiki>http://api.anidb.net:9001/httpapi?client={str}&clientver={int}&protover=1&request=hotanime</nowiki></u>


== Data ==
<pre>
<hotanime>
    <anime id="8556" restricted="false">
        <episodecount>12</episodecount>
        <startdate>2012-01-10</startdate>
        <title xml:lang="x-jat" type="main">Another</title>
        <ratings>
            <permanent count="248">6.61</permanent>
            <temporary count="261">7.88</temporary>
            <review count="1">4.33</review>
        </ratings>
        <picture>79963.jpg</picture>
    </anime>


<code><pre>
...
<?xml version="1.0" encoding="utf-8" ?>
<search>
  <anime id="1">
      <titles>
        <!-- always includes the main title as well as all official titles, synonyms and short tiles are not listed -->
        <title type="main" lang="x-jat">Seikai no Monshou</title>
        <title type="official" lang="ja">星界の紋章</title>
        <title type="official" lang="en">Crest of the Stars</title>
        <title type="official" lang="fr">Crest of the Stars</title>
        <title type="official" lang="pl">Crest of the Stars</title>
      </titles>
  </anime>
  <anime id="2">
      <titles>
        ...
      </titles>
  </anime>
  ...
</search>
</pre></code>


= Anime Data =
</hotanime>
</pre>


Allows retrieval of non-file or episode related information for a specific anime by AID (AniDB anime id).
=== Main ===


== Access ==
A one-stop command returning the combined results of random recommendation, random similar, and hot anime.  Use this command instead of scraping the HTML, and if you need more than one of the individual replies.


Base URL: TBA
==== Access ====
Base URL: <u><nowiki>http://api.anidb.net:9001/httpapi?request=main</nowiki></u>


Parameters:
Parameters:
* aid={integer} [required]
* <tt>request=main</tt>
** AniDB anime id of the anime you want to retrieve data for.
 
Example:
URL: <u><nowiki>http://api.anidb.net:9001/httpapi?client={str}&clientver={int}&protover=1&request=main</nowiki></u>
 
<pre>
<main>
    <hotanime>
        <anime id="8556" restricted="false">
            <episodecount>12</episodecount>
            <startdate>2012-01-10</startdate>
            <title xml:lang="x-jat" type="main">Another</title>
            <ratings>
                <permanent count="248">6.61</permanent>
                <temporary count="261">7.88</temporary>
                <review count="1">4.33</review>
            </ratings>
            <picture>79963.jpg</picture>
        </anime>
 
        ...
 
    </hotanime>
    <randomsimilar>
        <similar>
            <source aid="8107" restricted="false">
                <title xml:lang="x-jat" type="main">A Channel: The Animation</title>
                <picture>59870.jpg</picture>
            </source>
            <target aid="4777" restricted="false">
                <title xml:lang="x-jat" type="main">Lucky Star</title>
                <picture>65555.jpg</picture>
            </target>
        </similar>
 
        ...
 
    <randomsimilar>
    <randomrecommendation>
        <recommendation>
            <anime id="44" restricted="false">
                <type>OVA</type>
                <episodecount>1</episodecount>
                <startdate>2000-05-24</startdate>
                <enddate>2000-05-24</enddate>
                <title xml:lang="x-jat" type="main">Amon Devilman Mokushiroku</title>
                <picture>14016.jpg</picture>
                <ratings>
                    <permanent count="317">387</permanent>
                    <recommendations>1</recommendations>
              </ratings>
          </anime>
      </recommendation>
 
      ....
 
    </randomrecommendation>
</main>
</pre>
 
== User Data Commands ==
 
=== User Mylist Summary ===
 
==== Access ====
Base URL: <u><nowiki>http://api.anidb.net:9001/httpapi?request=mylistsummary&user={str anidb username}&pass={str anidb password}[&output=xml|json]</nowiki></u>


Parameters:
* <tt>request=mylistsummary</tt>
** Returns a list of the user's anime list in summary form, roughly matching the data in the "my list" page of the web interface.
* <tt>user={str username}&pass={str password}</tt>
** The user name and password of the desired user.  This is their main password, not the API password specified in the profile.


Example:
Example:
URL: http://.../animedb.pl?show=xmlapi&...&t=anime&aid=1832
URL: <u><nowiki>http://api.anidb.net:9001/httpapi?client={str}&clientver={int}&protover=1&request=mylistsummary&user={str}&pass={str}</nowiki></u>
 
<pre>
<mylistsummary uid="40237">
    <mylistitem aid="5841" state="2">
        <episodecount>22</episodecount>
        <seencount>22</seencount>
        <specialcount>9</specialcount>
        <seenspecialcount>4</seenspecialcount>
    </mylistitem>
<mylistsummary>
</pre>
 
=== User Hints ===
 
Returns a list of unwatched titles and a calculated rating, based upon existing votes.  The list may be empty if the requested user is very new, has not voted for enough titles, or has very stale (a number of months old) data.
 
Hints are calculated once a day.
 
==== Access ====
Base URL: <u><nowiki>http://api.anidb.net:9001/httpapi?request=hints&user={str anidb username}&pass={str anidb password}&type=1[&output=xml|json]</nowiki></u>


Parameters:
* <tt>request=hints</tt>
* <tt>user={str username}&pass={str password}</tt>
** The user name and password of the desired user.  This is their main password, not the API password specified in the profile.
* <tt>type=1</tt>
** always 1, but must be included.


== Data ==
Example:
URL: <u><nowiki>http://api.anidb.net:9001/httpapi?client={str}&clientver={int}&protover=1&request=hints&user={str}&pass={str}&type=1</nowiki></u>


<code><pre>
<pre>
<?xml version="1.0" encoding="utf-8" ?>
<hints uid="40237" type="1">
<anime id="1">
    <hint adddate="2015-03-23">
  <url>http://anidb.net/a1</url>
        <relid>5</relid>
  <titles>
        <calculated>8.09</calculated>
      <!-- should we include all titles or are official+main title enough? -->
    </hint>
      <title type="main" lang="x-jat">Seikai no Monshou</title>
</hints>
      <title type="official" lang="ja">星界の紋章</title>
</pre>
      <title type="official" lang="en">Crest of the Stars</title>
      <title type="official" lang="fr">Crest of the Stars</title>
      <title type="official" lang="pl">Crest of the Stars</title>
  </titles>
  <type>TV Series</type>
  <episodecount>13</episodecount>
  <date>
      <!-- note: dates can also be YYYY-MM-?? and YYYY-??-?? -->
      <from>1999-01-03</from>
      <till>1999-03-28</from>
  </date>
  <categories>
      <category id="233" weight="6">Dynamic::Plot Continuity</category>
      <category id="4" weight="4">Elements::Action</category>
      ...
  <categories>
  <producers>
      <producer id="34" type="Financial Production">Bandai Visual</producer>
      <producer id="108" type="Music Production">BeSTACK</producer>
      ...
  </producers>
  <relations>
      <!-- relations are always listed with official transcription title -->
      <relation type="sequel" aid="4">Seikai no Senki</type>
      <relation type="prequel" aid="6">Seikai no Danshou</type>
      <relation type="summary" aid="1623">Seikai no Monshou Movie</type>
  </relations>
  <ratings>
      <rating type="permanent" count="2333">8.54</rating>
      <rating type="temporary" count="82">7.61</rating>
      <rating type="review" count="9">9.01</rating>
  </ratings>
  <images>
      <image size="full">http://img5.anidb.net/pics/anime/440.jpg</image>
      <image size="small">http://img5.anidb.net/pics/anime/thumbs/150/440.jpg-thumb.jpg</image>
      <image size="tiny">http://img5.anidb.net/pics/anime/thumbs/50/440.jpg-thumb.jpg</image>
  </images>
  <description>
Jinto Lin's life changes forever when the Humankind Empire Abh takes over his home planet of Martine without firing a single shot. He is soon sent off to study the Abh language and culture and to prepare himself for his future as a nobleman - a future he never dreamed of. Or wanted.


Now, Jinto is entering the next phase of his training, and he is about to meet his first Abh, the lovely Lafiel. But Jinto is about to learn that she is more than she appears to be. And together they will have to fight for their very lives.
[[Category:Development]]
  </description>
[[Category:API]]
</anime>
</pre></code>
83

edits

MediaWiki spam blocked by CleanTalk.
MediaWiki spam blocked by CleanTalk.