Werke entdecken

GET/v1/search/works/explore

Die gefilterte Suche hinter der Entdecken-Seite: Kombiniere Genres, Themen, Formate, Seasons, Jahre, Wertungen, Studios und mehr und erhalte für jeden Filterwert eine Anzahl.

Anfrage

Shell

curl "https://api.nogitsu.com/v1/search/works/explore?medium=anime&genres=fantasy"

Parameter

q
Queryoptional
Zu suchender Text.
Text
medium
Queryoptional
Nur Werke dieses Mediums.
Text
Erlaubte Werteanimedonghuaanimationmangamanhwamanhuawebtoon
genres
Queryoptional
Nur Werke mit all diesen Genres; Slugs durch Kommas getrennt.
eine von mehreren Formen
themes
Queryoptional
Nur Werke mit all diesen Themen; Slugs durch Kommas getrennt.
eine von mehreren Formen
demographics
Queryoptional
Nur Werke für eine dieser Zielgruppen; Slugs durch Kommas getrennt.
eine von mehreren Formen
excludedWarnings
Queryoptional
Werke mit diesen Inhaltswarnungen auslassen; Slugs durch Kommas getrennt.
eine von mehreren Formen
statuses
Queryoptional
Nur Werke mit diesen Erscheinungsstatus, durch Kommas getrennt.
eine von mehreren Formen
formats
Queryoptional
Nur Werke in diesen Formaten, durch Kommas getrennt.
eine von mehreren Formen
seasons
Queryoptional
Nur Werke, die in diesen Seasons gestartet sind, durch Kommas getrennt.
eine von mehreren Formen
countries
Queryoptional
Nur Werke aus diesen Herkunftsländern; zweibuchstabige Codes durch Kommas getrennt.
eine von mehreren Formen
readingDirections
Queryoptional
Nur Werke mit diesen Leserichtungen, durch Kommas getrennt.
eine von mehreren Formen
contentRatings
Queryoptional
Nur Werke mit diesen Altersfreigaben, durch Kommas getrennt.
eine von mehreren Formen
visibleContentRatings
Queryoptional
Einzuschließende Altersfreigaben, durch Kommas getrennt: all_ages, teen, mature, adult. Lass den Parameter weg, um Werke für Erwachsene auszublenden.
Text
studios
Queryoptional
Nur Werke dieses Studios. Wiederhole den Parameter, um eines von mehreren Studios zuzulassen.
eine von mehreren Formen
publishers
Queryoptional
Nur Werke dieses Verlags. Wiederhole den Parameter, um einen von mehreren Verlagen zuzulassen.
eine von mehreren Formen
creators
Queryoptional
Nur Werke dieses Urhebers. Wiederhole den Parameter, um einen von mehreren Urhebern zuzulassen.
eine von mehreren Formen
yearFrom
Queryoptional
Nur Werke, die in diesem Jahr oder später gestartet sind.
Ganzzahl
Von 1900 bis 2100
yearTo
Queryoptional
Nur Werke, die in diesem Jahr oder früher gestartet sind.
Ganzzahl
Von 1900 bis 2100
scoreMin
Queryoptional
Nur Werke mit mindestens dieser Wertung, von 0 bis 10.
Zahl
Von 0 bis 10
unitsMin
Queryoptional
Nur Werke mit mindestens so vielen Folgen oder Kapiteln.
Ganzzahl
Von 0 bis 100000
unitsMax
Queryoptional
Nur Werke mit höchstens so vielen Folgen oder Kapiteln.
Ganzzahl
Von 0 bis 100000
durationMin
Queryoptional
Nur Werke, deren Folgen mindestens so viele Minuten dauern.
Ganzzahl
Von 0 bis 100000
durationMax
Queryoptional
Nur Werke, deren Folgen höchstens so viele Minuten dauern.
Ganzzahl
Von 0 bis 100000
volumesMin
Queryoptional
Nur Werke mit mindestens so vielen Bänden.
Ganzzahl
Von 0 bis 100000
volumesMax
Queryoptional
Nur Werke mit höchstens so vielen Bänden.
Ganzzahl
Von 0 bis 100000
hasTrailer
Queryoptional
true, um nur Werke mit Trailer zu erhalten.
Text
sort
Queryoptional
Reihenfolge der Ergebnisse.
Text
Erlaubte Werterelevancepopularityscorenewest
Standard: popularity
page
Queryoptional
Seitenzahl, beginnend bei 1.
Ganzzahl
Von 1 bis 100Standard: 1

Antwort

Eine erfolgreiche Anfrage antwortet mit 200 und diesem JSON:

hitsListe von Objekt
- idText (uuid)
- mediumText
  Erlaubte Werteanimedonghuaanimationmangamanhwamanhuawebtoon
- slugText
- titleText
- nativeTitleTextkann null sein
- romanizedTitleTextkann null sein
- contentRatingText
  Erlaubte Werteunknownall_agesteenmatureadult
- publicationFormatText
  Erlaubte Wertetvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatusText
  Erlaubte Wertenot_yet_releasedreleasingfinishedhiatuscancelledunknown
- yearGanzzahlkann null sein
  Von -9007199254740991 bis 9007199254740991
- scoreGanzzahlkann null sein
  Von 0 bis 1000
- coverObjektkann null sein
  urlText (uri)
  variantWidthsListe von Ganzzahl
  Von 0 bis 9007199254740991
- contentWarningsListe von Text
  Erlaubte Werteviolencegoresexual-contentsuicide
foundGanzzahl
Von 0 bis 9007199254740991
pageGanzzahl
Von 0 bis 9007199254740991
pageSizeGanzzahl
Von 0 bis 9007199254740991
facetsObjekt
- genresListe von Objekt
  valueText
  countGanzzahl
  Von 0 bis 9007199254740991
- themesListe von Objekt
  valueText
  countGanzzahl
  Von 0 bis 9007199254740991
- demographicsListe von Objekt
  valueText
  countGanzzahl
  Von 0 bis 9007199254740991
- contentWarningsListe von Objekt
  valueText
  countGanzzahl
  Von 0 bis 9007199254740991
- statusesListe von Objekt
  valueText
  countGanzzahl
  Von 0 bis 9007199254740991
- formatsListe von Objekt
  valueText
  countGanzzahl
  Von 0 bis 9007199254740991
- seasonsListe von Objekt
  valueText
  countGanzzahl
  Von 0 bis 9007199254740991
- countriesListe von Objekt
  valueText
  countGanzzahl
  Von 0 bis 9007199254740991
- readingDirectionsListe von Objekt
  valueText
  countGanzzahl
  Von 0 bis 9007199254740991
- contentRatingsListe von Objekt
  valueText
  countGanzzahl
  Von 0 bis 9007199254740991
- studiosListe von Objekt
  valueText
  countGanzzahl
  Von 0 bis 9007199254740991
- publishersListe von Objekt
  valueText
  countGanzzahl
  Von 0 bis 9007199254740991
- creatorsListe von Objekt
  valueText
  countGanzzahl
  Von 0 bis 9007199254740991

Fehler

Wie jede Operation kann auch diese mit 400 bei ungültigen Parametern antworten, mit 404, wenn nichts gefunden wird, und mit 429, wenn du zu viele Anfragen sendest. Alle Fehler haben dieselbe Form.

Mehr über Fehler