API de metadados de filmes multilíngue

Obtenha dados de filmes em 14 idiomas

GET /3/movie/{movie_id}?language=ru-RU retorna o título, a sinopse, o slogan e os nomes dos gêneros em russo. O parâmetro language aceita tags do TMDB como ru-RU ou pt-BR e funciona em todo endpoint que retorna texto. Os ids são os mesmos em todos os idiomas, então uma linha no seu banco de dados serve a todos eles.

Você recebe 14 idiomas com uma chave, o original_title de todo filme, um endpoint de traduções que lista todos os idiomas de um título e nomes de gêneros localizados. A lista completa está em idiomas.

Os 14 idiomas atendidos

Qualquer outra tag volta para en. Japonês e coreano não são atendidos como idiomas de interface. Os títulos originais deles continuam voltando em original_title nos filmes e em original_name nas séries de TV.

Quais dados você recebe

Comece em 3 passos

1. Escolha um plano em preços. O número de idiomas não muda com o plano, só a taxa de requisições.
2. Crie uma chave no painel da sua conta.
3. Chame qualquer endpoint com uma tag em language e envie a chave como api_key ou como header Bearer.

Exemplo de requisição

O exemplo em bash imprime o título de Fight Club (id 550) em três idiomas. Ele usa jq para imprimir um campo. O exemplo em PHP pede bielorrusso e volta para o inglês quando a sinopse está em branco.

for lang in en-US ru-RU he-IL; do
  curl -s "https://api.amodb.dev/3/movie/550?language=$lang" \
    -H "Authorization: Bearer $AMODB_KEY" | jq -r '.title'
done

<?php
function amodb(string $path, array $query = []): array
{
    $url = 'https://api.amodb.dev/3' . $path . '?' . http_build_query($query);
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 10,
        CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('AMODB_KEY')],
    ]);
    $body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    if ($status !== 200) {
        throw new RuntimeException("amodb returned $status");
    }
    return json_decode($body, true);
}

function localizedMovie(int $id, string $lang): array
{
    $movie = amodb("/movie/$id", ['language' => $lang]);
    $movie['text_language'] = $lang;
    if (trim($movie['overview'] ?? '') === '') {
        $fallback = amodb("/movie/$id", ['language' => 'en-US']);
        $movie['overview'] = $fallback['overview'] ?? '';
        $movie['text_language'] = 'en-US';
    }
    return $movie;
}

$movie = localizedMovie(550, 'be-BY');
echo $movie['title'], ' (', $movie['original_title'], ')', PHP_EOL;
echo '[', $movie['text_language'], '] ', $movie['overview'], PHP_EOL;

Resposta para language=ru-RU, reduzida a alguns campos. A chave text_language no exemplo em PHP é adicionada pelo seu código, não pela API.

{
  "genres": [
    {
      "id": 18,
      "name": "драма"
    },
    {
      "id": 53,
      "name": "триллер"
    }
  ],
  "id": 550,
  "original_language": "en",
  "original_title": "Fight Club",
  "overview": "Сотрудник страховой компании страдает хронической бессонницей и отчаянно пытается вырваться из мучительно скучной жизни. Однажды в очередной командировке он...",
  "poster_path": "/66RvLrRJTm4J8l3uHXWF09AICol.jpg",
  "tagline": "«Интриги. Хаос. Мыло»",
  "title": "Бойцовский клуб"
}

Alternativa quando um campo está vazio

Nem todo título tem texto em todos os idiomas. Uma overview pode voltar vazia quando não existe tradução, e um title ou tagline pode voltar em inglês. A API não inventa texto. Use uma ordem fixa para que a página sempre mostre algo:

1. Peça o idioma que você exibe.
2. Se um campo estiver vazio, peça en-US para o mesmo id ou leia a entrada em inglês da lista de traduções.
3. Se o título estiver vazio, mostre original_title.
4. Guarde de qual idioma cada campo veio, para poder tentar de novo depois.

O cache de borda guarda uma cópia por idioma para cada caminho em cache, então a alternativa em inglês de um título popular costuma ser servida do cache.

Liste todas as traduções de um título

GET /3/movie/{movie_id}/translations retorna um array translations, com uma entrada por idioma que tem dados. A lista pode ser maior que os 14 idiomas atendidos: Fight Club tem 50 entradas. Use-a para montar um seletor de idioma ou para guardar todos os textos de um título em uma só linha.

O mesmo endpoint existe para séries de TV e episódios. As entradas de TV trazem data.name e não têm runtime, e as entradas de episódio trazem só name e overview. As temporadas respondem com uma lista vazia, e pessoas e coleções não têm endpoint de traduções. Os detalhes estão em traduções. Uma chamada de traduções substitui até 14 chamadas de detalhes quando você quer todos os idiomas de uma vez.

Pôsteres e vídeos por idioma

Imagens e vídeos têm suas próprias tags de idioma em iso_639_1. Nos endpoints de imagens, passe uma lista separada por vírgulas e adicione null para itens sem idioma, como pôsteres sem texto. A resposta contém os itens correspondentes, então classifique-os no seu código.

Os endpoints de vídeos retornam todos os idiomas em uma só resposta e ignoram include_video_language, então filtre você mesmo por iso_639_1. Veja imagens para tamanhos e a CDN.

Hebraico e texto da direita para a esquerda

O hebraico é o único idioma da direita para a esquerda entre os 14. Trate isso na página, não nos dados:

• Defina lang="he" e dir="rtl" no elemento que contém o texto.
• Envolva títulos em alfabeto latino dentro de texto hebraico em um elemento <bdi>, para que a pontuação não pule para o lado errado.
• Use propriedades lógicas de CSS como margin-inline-start em vez de esquerda e direita.

Como se compara

Preços

O conjunto de idiomas é o mesmo em todos os planos, então você paga só pela taxa e pelo período. Compre 1, 3, 6, 12 ou 24 meses pré-pagos, com 0, 10, 20, 30 ou 40 por cento de desconto nos mais longos e sem renovação automática. Os planos de 20, 40 e 120 requisições por minuto incluem todos os idiomas e todos os endpoints. Um site em cinco idiomas precisa de até cinco chamadas de detalhes por título, e as requisições repetidas são servidas do cache de borda por 6 horas. Sem plano gratuito. Veja preços.