Vai al contenuto

Cerca opere

GET/v1/search/works

Restituisce le opere i cui titoli corrispondono a un testo, a partire dai risultati migliori.

Richiesta

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

Parametri

  • q

    queryobbligatorio

    Testo da cercare.

    testo

  • medium

    queryfacoltativo

    Solo opere di questo tipo.

    testo

    Valori consentitianimedonghuaanimationmangamanhwamanhuawebtoon
  • limit

    queryfacoltativo

    Quanti elementi restituire in una pagina.

    numero intero

    Da 1 a 25Predefinito: 10

  • visibleContentRatings

    queryfacoltativo

    Classificazioni per età da includere, separate da virgole: all_ages, teen, mature, adult. Omettilo per nascondere le opere per adulti.

    testo

Risposta

Una richiesta riuscita risponde 200 con questo JSON:

  • hitselenco di oggetto
    • idtesto (uuid)
    • mediumtesto
      Valori consentitianimedonghuaanimationmangamanhwamanhuawebtoon
    • slugtesto
    • titletesto
    • nativeTitletestopuò essere null
    • romanizedTitletestopuò essere null
    • contentRatingtesto
      Valori consentitiunknownall_agesteenmatureadult
    • publicationFormattesto
      Valori consentititvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
    • releaseStatustesto
      Valori consentitinot_yet_releasedreleasingfinishedhiatuscancelledunknown
    • yearnumero interopuò essere null

      Da -9007199254740991 a 9007199254740991

    • scorenumero interopuò essere null

      Da 0 a 1000

    • coveroggettopuò essere null
      • urltesto (uri)
      • variantWidthselenco di numero intero

        Da 0 a 9007199254740991

    • contentWarningselenco di testo
      Valori consentitiviolencegoresexual-contentsuicide
  • foundnumero intero

    Da 0 a 9007199254740991

Errori

Come ogni operazione, questa può rispondere 400 per parametri non validi, 404 quando non trova nulla e 429 quando invii troppe richieste. Tutti gli errori condividono la stessa forma.

Leggi sugli errori