# Alternativa à API do TVmaze > O TVmaze cobre só TV, é gratuito, tem limite de requisições por endereço IP e seus dados estão sob uma licença de atribuição. Consulte a documentação deles para os detalhes. O amodb é uma API paga de TV, filmes e pessoas, com limites contados por chave e caminhos TMDB v3. Escolha pelo escopo e pelo orçamento. ## Escolha pelo escopo e pelo orçamento O TVmaze cobre só TV. É uma API pública de uso gratuito com limites por endereço IP, e seus dados vêm sob uma licença de atribuição, então consulte a documentação deles para os detalhes. O amodb é pago e cobre TV, filmes e pessoas. Se o seu app é um rastreador de séries e uma fonte gratuita atende, o TVmaze é um começo sensato. Se você também mostra filmes, páginas de elenco ou pôsteres em vários idiomas, uma chave do amodb substitui várias fontes. ## O que cada escopo significa para o seu app | O seu app mostra | TVmaze | amodb | | ------------------------- | ----------------------------- | ------------------------------------------------- | | Página de uma série de TV | Sim | `GET /3/tv/{series_id}` | | Lista de episódios | Sim | `GET /3/tv/{series_id}/season/{season_number}` | | Página de um filme | Sem filmes | `GET /3/movie/{movie_id}` | | Página de um ator | Consulte a documentação deles | `GET /3/person/{person_id}` e créditos combinados | | Séries no ar hoje | Consulte a documentação deles | `GET /3/tv/airing_today` | | Uma sinopse traduzida | Consulte a documentação deles | Parâmetro `language`, 14 idiomas | | Notas de vários sites | Consulte a documentação deles | Extensão `/ratings` | A linha dos filmes decide a maioria dos casos. Se você não tem páginas de filmes, o escopo extra não tem valor para você. ## Lacunas a verificar antes de migrar Os endpoints de temporada e episódio seguem o formato do TMDB, e algumas partes deles voltam vazias. Teste as telas que os usam. - **Elenco do episódio.** Em um episódio, `cast` é um array vazio. `guest_stars` e `crew` vêm preenchidos, e a chamada `/credits` da série traz o elenco principal. - **Extras da temporada.** `images`, `videos` e `translations` da temporada vêm vazios, então o pôster de uma temporada vem do registro da temporada e não de uma lista de imagens. - **IDs externos.** Os `external_ids` de temporada e episódio são todos null. Relacione episódios com os seus próprios registros por `season_number` e `episode_number`. - **Criadores.** `created_by` de uma série vem vazio na maioria das séries. - **Sem feed de alterações.** O amodb não tem um endpoint que liste as séries alteradas desde uma data. ## Comparação de recursos | Recurso | TVmaze | amodb | | --------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------- | | Modelo de preço | API pública de uso gratuito | Pré-pago, de 1 a 24 meses por compra | | Plano gratuito | Sim, toda a API pública | Nenhum, e sem período de teste | | Autenticação | Consulte a documentação deles | `api_key` ou cabeçalho Bearer | | Formato da resposta | JSON, consulte a documentação deles | JSON no formato TMDB v3 | | Idiomas | Consulte a documentação deles | 14 idiomas de interface | | Filmes | Não | Sim | | TV | Sim, o único foco | Sim | | Pessoas | Consulte a documentação deles | Sim | | Imagens | Consulte a documentação deles | `img.amodb.dev`, dez tokens de tamanho | | Avaliações | Consulte a documentação deles | Cinco fontes, quando conhecidas | | Limite de requisições | Por endereço IP, consulte a documentação deles para ver os números | 20, 40 ou 120 por minuto por chave | | Uso comercial | Dados sob licença de atribuição, consulte a documentação deles | Planos pagos, veja [preços](https://amodb.dev/pt/pricing/) | | Compatibilidade | API própria | Leituras do TMDB v3 e OMDb | ## Onde o amodb se diferencia - **O limite acompanha a chave.** Todos os seus servidores compartilham um contador em uma janela deslizante de 60 segundos, e as respostas trazem `X-RateLimit-Remaining`. Nada depende do endereço de onde a requisição sai. - **Filmes, TV e pessoas num só lugar.** Um cliente, um formato de erro e um conjunto de cabeçalhos cobrem o app inteiro. - **Idiomas.** Títulos e sinopses voltam em qualquer um dos 14 idiomas, e `original_name` mantém o título nativo. - **Protocolo consolidado.** Bibliotecas escritas para as leituras do TMDB v3 funcionam com uma nova URL base. Veja a página da [API de séries de TV](https://amodb.dev/pt/tv-show-api/) para os endpoints de séries. ## Onde o TVmaze é mais indicado - **Sem orçamento.** É de uso gratuito, então um projeto de estudante ou um rastreador de fim de semana não exige pagamento. O amodb não tem plano gratuito nem período de teste. - **Só TV, sem complicação.** Se o seu modelo de dados tem séries e episódios e mais nada, uma API focada em TV combina com ele. - **As próprias convenções.** Apps já construídos em torno do modelo do TVmaze economizam trabalho ao ficar. Se você ficar, siga a licença de atribuição dele. Consulte a documentação deles para ver o texto. ## Migrar para o amodb Comece com um job de mapeamento. Leia os IDs externos que os seus registros guardados do TVmaze listam (consulte a documentação deles para os nomes dos campos) e resolva-os por `/3/find`. O programa abaixo mapeia um ID do IMDb para uma série e imprime a data do próximo episódio. ```go package main import ( "encoding/json" "fmt" "net/http" "os" "time" ) type findResult struct { TVResults []struct { ID int `json:"id"` Name string `json:"name"` } `json:"tv_results"` } type episode struct { AirDate string `json:"air_date"` SeasonNumber int `json:"season_number"` EpisodeNumber int `json:"episode_number"` } type series struct { Name string `json:"name"` Status string `json:"status"` NextEpisode *episode `json:"next_episode_to_air"` } var client = &http.Client{Timeout: 10 * time.Second} func get(path string, out any) error { req, err := http.NewRequest(http.MethodGet, "https://api.amodb.dev/3"+path, nil) if err != nil { return err } req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY")) res, err := client.Do(req) if err != nil { return err } defer res.Body.Close() if res.StatusCode != http.StatusOK { return fmt.Errorf("amodb returned %s", res.Status) } return json.NewDecoder(res.Body).Decode(out) } func main() { var found findResult if err := get("/find/tt0903747?external_source=imdb_id", &found); err != nil { fmt.Println(err) return } if len(found.TVResults) == 0 { fmt.Println("no match") return } var s series if err := get(fmt.Sprintf("/tv/%d", found.TVResults[0].ID), &s); err != nil { fmt.Println(err) return } fmt.Println(s.Name, s.Status) if s.NextEpisode != nil { fmt.Println("next episode:", s.NextEpisode.AirDate) } } ``` O tipo ponteiro para `NextEpisode` lida com o `null` que séries encerradas retornam. Rode o mapeamento uma vez, salve o ID do amodb em cada um dos seus registros e chame `/3/tv/{id}` daí em diante. Um 429 é respondido com `Retry-After`, e a página [busca por ID externo](https://amodb.dev/pt/find-by-external-id/) lista as outras fontes de ID. ## Dimensionar uma sincronização noturna Suponha que você atualize 300 séries por noite. São 300 requisições, já que uma chamada de série retorna uma série. A 20 requisições por minuto o job leva 15 minutos, a 40 leva 7.5 minutos e a 120 leva 2.5 minutos. Acrescente `append_to_response=credits,ratings` a cada chamada para que elenco e notas cheguem na mesma requisição, em vez de custar mais duas por série. Leia `X-RateLimit-Remaining` e pause quando chegar a zero, depois continue após os segundos de `X-RateLimit-Reset`. ## Preços O amodb é pré-pago e nunca renova sozinho. Escolha 1, 3, 6, 12 ou 24 meses e um plano de 20, 40 ou 120 requisições por minuto. Períodos mais longos saem 10, 20, 30 ou 40 por cento mais baratos, e cada plano inclui todos os dados. Os valores estão em [preços](https://amodb.dev/pt/pricing/). ## Perguntas e respostas ### A API do TVmaze é gratuita? O TVmaze oferece uma API pública gratuita com limites por endereço IP, e seus dados estão sob uma licença de atribuição. Consulte a documentação deles para ver os limites atuais e o texto da licença. O amodb é pago e não tem plano gratuito. ### O amodb cobre filmes além de TV? Sim. Filmes, séries de TV, temporadas, episódios e pessoas ficam na mesma chave e na mesma URL base. O TVmaze é só de TV, então a página de um filme no seu app precisa de uma segunda fonte. ### Como mapeio séries do TVmaze para IDs do amodb? Os registros de série do TVmaze listam IDs de outros bancos, como o IMDb (consulte a documentação deles para os campos exatos). Chame o endpoint find com o ID do IMDb e external_source=imdb_id, e depois guarde o ID de tv_results. ### Por que um limite por IP importa? Um limite atrelado a um endereço IP é compartilhado por tudo que está atrás dele, como um pool de servidores ou uma rede de escritório. O amodb conta as requisições por chave em uma janela deslizante de 60 segundos, não importa de onde vêm as chamadas. ### Posso mostrar a data do próximo episódio de uma série? Sim. Os detalhes da série retornam next_episode_to_air com air_date, season_number e episode_number, ou null quando nada está programado. A borda guarda os detalhes em cache por 6 horas, então atualize algumas vezes por dia. ## Páginas relacionadas - [API de séries de TV: séries, temporadas e episódios](https://amodb.dev/pt/tv-show-api/): API de séries de TV com status, emissoras, temporadas, episódios e next_episode_to_air. JSON do TMDB v3 em 14 idiomas, a partir de 20 requisições por minuto. - [API de guia de episódios](https://amodb.dev/pt/episode-guide-api/): API de guia de episódios com os endpoints de temporada e episódio do TMDB v3: nomes, datas de exibição, durações, imagens e grupos de episódios, em 14 idiomas. - [API de temporadas e episódios de séries](https://amodb.dev/pt/tv-seasons-episodes/): API de temporadas e episódios com os mesmos caminhos e JSON do TMDB v3. Leia uma temporada com todos os episódios, ou um episódio com data, duração e still. - [Buscar por ID externo](https://amodb.dev/pt/find-by-external-id/): Busque um filme, série ou pessoa por id do IMDb, TVDB, Wikidata ou Kinopoisk com o endpoint find do TMDB e leia ids externos e dados do Wikidata de um título. - [Limites de requisições](https://amodb.dev/pt/rate-limits/): O amodb limita cada chave por requisições por minuto em uma janela de 60 segundos: 20, 40 ou 120 por plano. Leia os cabeçalhos e trate o 429 com Retry-After. - [Preços](https://amodb.dev/pt/pricing/): Os planos do amodb diferem só em requisições por minuto: 20, 40 ou 120. Todo plano inclui todos os dados do TMDB v3 e OMDb. Pré-pago, sem renovação nem teste. Atualizado: 2026-10-18. Source: https://amodb.dev/pt/tvmaze-api-alternative/