Pular para o conteúdo

Listar empresas

GET/v1/companies

Retorna o diretório de empresas com busca por nome e um filtro por função.

Requisição

Shell
curl "https://api.nogitsu.com/v1/companies"

Parâmetros

  • q

    consultaopcional

    Texto a buscar.

    texto

  • cursor

    consultaopcional

    O valor de nextCursor da página anterior. Omita-o na primeira página.

    texto

  • sort

    consultaopcional

    Ordem dos resultados.

    texto

    Valores permitidospopularworksnameoldestnewest
  • role

    consultaopcional

    Apenas empresas cujas principais funções incluem esta.

    texto

    Valores permitidosanimation_studioproducerpublishermagazineplatformlicensor

Resposta

Uma requisição bem-sucedida responde 200 com este JSON:

  • itemslista de objeto
    • idtexto (uuid)
    • slugtexto
    • nametexto
    • nativeNametextopode ser null
    • pathtexto
    • imageobjetopode ser null
      • urltexto (uri)
      • widthnúmero inteiropode ser null

        De 0 a 9007199254740991

      • heightnúmero inteiropode ser null

        De 0 a 9007199254740991

      • blurhashtextopode ser null
      • providertextopode ser null
        Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthslista de número inteiro

        De 0 a 9007199254740991

    • knownForobjetopode ser null
      • idtexto (uuid)
      • slugtexto
      • mediumtexto
        Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormattexto
        Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatustexto
        Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
      • titletexto
      • nativeTitletextopode ser null
      • romanizedTitletextopode ser null
      • contentRatingtexto
        Valores permitidosunknownall_agesteenmatureadult
      • startYearnúmero inteiropode ser null

        De -9007199254740991 a 9007199254740991

      • coverobjetopode ser null
        • urltexto (uri)
        • widthnúmero inteiropode ser null

          De 0 a 9007199254740991

        • heightnúmero inteiropode ser null

          De 0 a 9007199254740991

        • blurhashtextopode ser null
        • providertextopode ser null
          Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidthslista de número inteiro

          De 0 a 9007199254740991

      • contentWarningslista de texto
        Valores permitidosviolencegoresexual-contentsuicide
    • workCountnúmero inteiro

      De 0 a 9007199254740991

    • roleslista de texto
    • gendertextopode ser null
      Valores permitidosfemalemalenon_binary
    • establishedobjetopode ser null
      • datetexto (date)
      • precisiontexto
        Valores permitidosdaymonthyearunknown
  • nextCursortextopode ser null

Erros

Como toda operação, esta pode responder 400 para parâmetros inválidos, 404 quando nada é encontrado e 429 quando você envia requisições demais. Todos os erros compartilham o mesmo formato.

Leia sobre erros