Preferências

Resposta rápida

Deseja automatizar sua busca por locutores? Acesse instantaneamente nosso banco de dados profissional de locutores via API — filtre por idioma, estilo ou categoria e obtenha perfis detalhados para integração rápida ao seu fluxo de trabalho. Rápido, flexível e sem necessidade de autenticação.

API De Consulta De Locutores

A API de Consulta de Locutores Voice Crafters fornece acesso programático ao nosso banco de dados de locutores. Use para buscar locutores por idioma, gênero, estilo, categoria e mais, ou para obter o perfil completo de um locutor específico.

As respostas são retornadas em formato JSON e armazenadas em cache por 5 minutos (Cache-Control: public, max-age=300). Não é necessária autenticação.

 

Endpoints

 

Buscar locutores

GET https://www.voicecrafters.com/api/voice-actors

Retorna uma lista paginada de locutores conforme os filtros aplicados. São 100 resultados por página.

 

Parâmetros de consulta

Todos os parâmetros são opcionais e podem ser combinados livremente.

Parâmetro Descrição Exemplo
idioma Idioma nativo (slug do termo) english-voice-actors
idioma_estrangeiro Idioma estrangeiro (slug do termo) spanish-voice-over-artists
gênero Gênero (slug do termo) male, female
estilo Estilo vocal (slug do termo) friendly, authoritative
categoria Categoria do locutor (slug do termo) commercials, audiobooks
tom Timbre vocal (slug do termo) deep, high
personagem Tipo de personagem (slug do termo) narrator, villain
imitação Imitação (slug do termo) celebridade
país País (slug do termo) estados-unidos
buscar Pesquisa por palavra-chave livre morgan
página Número da página (padrão1) 2

 

Exemplo de requisição

curl "https://www.voicecrafters.com/api/voice-actors?language=english-voice-actors&gender=male&page=1"

 

Exemplo de resposta

, "foreign_languages": ["spanish"], "gender": "female", "country": "united states", "styles": ["commercial", "narration"], "minimum_rate": "250", "labels": ["top rated"], "main_demo_url": "https://...", "available": true } ], "total": 350, "page": 1, "per_page": 100 }
{ "results":
, "foreign_languages": ["spanish"], "gender": "female", "country": "united states", "styles": ["commercial", "narration"], "minimum_rate": "250", "labels": ["top rated"], "main_demo_url": "https://...", "available": true } ], "total": 350, "page": 1, "per_page": 100 }[ { "name": "John Smith", "description": "Professional voice actor with a warm, friendly tone...", "url": "https://www.voicecrafters.com/voice-actor/john-smith/", "api_url": "https://www.voicecrafters.com/api/voice-actor/john-smith", "photo": "https://www.voicecrafters.com/wp-content/uploads/photo.jpg", "rating": 4.9, "review_count": 42, "languages": ["English"], "foreign_languages": ["Spanish"], "gender": "Male", "country": "United States", "styles":["warm", "friendly"], "minimum_rate": "100", "labels": ["Top Talent"], "main_demo_url": "https://www.voicecrafters.com/wp-content/uploads/demo.mp3", "available": true } ], "total": 523, "page": 1, "per_page": 100 }

 

Perfil do locutor

GET https://www.voicecrafters.com/api/voice-actor/{slug}

Retorna o perfil completo de um locutor. {slug} é o slug na URL do locutor (o trecho após /voice-actor/ no endereço do perfil).

 

Exemplo de requisição

curl "https://www.voicecrafters.com/api/voice-actor/john-smith"

 

Exemplo de resposta

{ "voice_actor": { "name": "John Smith", "url": "https://www.voicecrafters.com/voice-actor/john-smith/", "photo": "https://www.voicecrafters.com/wp-content/uploads/photo.jpg", "rating": 4.9, "review_count": 42, "languages": ["English"], "foreign_languages": ["Spanish"], "gender": "Male", "country": "United States", "styles":["warm", "friendly"], "minimum_rate": "100", "labels": ["Top Talent"], "available": true, "about": "Ator de voz profissional com mais de 10 anos de experiência...", "experience": "10+ anos", "credentials": "Membro SAG-AFTRA, AVO Certified", "companies": "Nike, Coca-Cola, Apple", "equipment": "Neumann TLM 103, Universal Audio Apollo Twin", "delivery_time": "24 horas", "age_range": ["Adulto", "Meia-idade"], "pitch": ["Médio"], "characters": ["Narrador"], "impersonations":[], "categories": ["Commercials", "Audiobooks"], "completed_jobs": 42, "demos": { "native":[
                {
                    "language": "English",
                    "category": "Commercial",
                    "url": "https://www.voicecrafters.com/wp-content/uploads/demo-en.mp3"
                }
            ], "foreign":[
                {
                    "language": "Spanish",
                    "category": "Commercial",
                    "url": "https://www.voicecrafters.com/wp-content/uploads/demo-es.mp3"
                }
            ]
        }
    }
}

 

Respostas de erro

HTTP status Corpo Significado
400 {"error": "Missing voice actor slug"} Nenhum slug informado após /api/voice-actor/
404 {"error": "Voice actor not found"} Nenhum locutor publicado corresponde ao slug informado

 

Notas

  • Todos os slugs seguem o mesmo padrão usado nas URLs públicas do site. Você pode encontrar o slug de qualquer termo de taxonomia inspecionando o endereço da página em voicecrafters.com.
  • As respostas incluem um cabeçalho X-Robots-Tag: noindex para evitar a indexação dos endpoints JSON por mecanismos de busca.
  • O campo api_url em cada resultado de busca aponta para o endpoint do perfil detalhado do locutor.