Werke suchen

GET/v1/search/works

Liefert Werke, deren Titel zu einem Text passen, die besten Treffer zuerst.

Anfrage

Shell

curl "https://api.nogitsu.com/v1/search/works?q=frieren"

Parameter

q
Queryerforderlich
Zu suchender Text.
Text
medium
Queryoptional
Nur Werke dieses Mediums.
Text
Erlaubte Werteanimedonghuaanimationmangamanhwamanhuawebtoon
limit
Queryoptional
Wie viele Elemente eine Seite liefern soll.
Ganzzahl
Von 1 bis 25Standard: 10
visibleContentRatings
Queryoptional
Einzuschließende Altersfreigaben, durch Kommas getrennt: all_ages, teen, mature, adult. Lass den Parameter weg, um Werke für Erwachsene auszublenden.
Text

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

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