AIDA

Analisa evolução histórica da pré-venda pela sale_date. Use para histórico, curva, pacing, vendas em data passada e acumulado até uma data passada. Para todo o histórico, use date_scope=full_history com um único movie_id; o Gateway descobre a primeira sale_date, sem janela arbitrária, e cutoff_date é inclusiva quando informada. O modo consolidated usa a série diária por filme com cobertura Ingresso.com; o modo detailed usa cobertura Ingresso.com por exibição. tickets_sold_preview significa ingressos vendidos antecipadamente para sessões classificadas como pré-estreia; pertence ao histórico de pré-venda, não representa público realizado e não substitui Resultado de Mercado. A resposta usa value_nature=historical_sales.

analisar_pacing_pre_venda

Analisa a fotografia atual da pré-venda. A base temporal é session_date e somente sessões de hoje ou futuras são válidas. Para 'pré-venda de hoje', filtre exatamente session_date=hoje; não use um intervalo aberto para o futuro. Para 'pré-venda atual' sem data específica, um intervalo aberto session_date>=hoje só é permitido quando a análise estiver seletivamente restrita por movie_id ou theater_id. Consultas amplas sem movie_id/theater_id exigem início e fim de session_date e no máximo 31 dias. Retorna value_nature=current_snapshot, não historical_sales. Não expõe granularidade de sala/sessão, não aceita paginação enumerável e não deve ser usada para reconstrução da base.

analisar_pre_venda_atual

Analisa Resultado de Mercado realizado em quatro modos controlados dentro da mesma ferramenta. weekly analisa por CineSemana com filtros, agrupamentos, ranking, totais e participação; daily_market consulta série ou agregado diário do mercado; movie_daily consulta série diária ou acumulado de um único movie_id canônico; cine_week_comparison compara uma CineSemana fechada com posições anuais equivalentes, sem deslocar datas civis e sem usar CineSemana.ANO isoladamente. Público usa admissions e renda usa gross. Resultado de pré-estreia deve usar fatos realizados e nunca tickets_sold_preview. Períodos futuros não são substituídos por pré-venda. movie_daily nunca é usado como total automático de mercado. A resposta usa value_nature=realized e preserva a fonte do modo selecionado. Esta ferramenta é exclusivamente analítica, não expõe granularidade de sala/sessão e não permite reconstrução ou exportação da base. No modo weekly, a CineSemana corrente é válida e deve retornar o resultado parcial realizado já consolidado pela fonte. Não exija o fechamento da semana para responder 'resultado desta semana'. Em uma sexta-feira, por exemplo, quinta-feira já pode compor o resultado; nos dias seguintes, use todo o acumulado realizado disponível. Não infira dias ainda não consolidados como zero. A exigência de CineSemana fechada é exclusiva de cine_week_comparison. No modo weekly, público deve ser lido exclusivamente pelas métricas públicas corretas para o recorte solicitado: admissions para o acumulado da CineSemana até o último dia consolidado, weekend_admissions para o fim de semana e thursday_admissions, friday_admissions, saturday_admissions, sunday_admissions, monday_admissions, tuesday_admissions ou wednesday_admissions para cada dia específico. Na fonte semanal, essas métricas correspondem respectivamente a Ocupados, FDS e aos campos Quinta, Sexta, Sabado, Domingo, Segunda, Terca e Quarta. QTD Tot nunca representa público e nunca deve ser usado como admissions, fallback, aproximação ou inferência. Nenhum outro campo ou métrica pode substituir essas referências de público no modo weekly. Para a CineSemana corrente no modo weekly, use exatamente um filtro temporal no formato {dimension: week_start, operator: between, from: YYYY-MM-DD, to: YYYY-MM-DD}, usando a quinta-feira inicial da CineSemana em from e to quando consultar uma única semana.

analisar_resultado_mercado

Audita ocupação histórica a partir da última posição persistida de occupied para sessões de D-1 ou anteriores. Exige session_date fechado com eq ou between e aceita no máximo 31 dias por chamada. Permite análise agregada por filme, cinema, rede, cidade, UF, faixa horária e outras dimensões públicas; room_id, room e session_hour são somente filtros seletivos. Para uma sessão pontual, combine filme/cinema/sala/data/horário. Não expõe IDs crus de ticketeira, registros brutos, URLs, mapas de assentos ou paginação enumerável. occupied não é bilheteria oficial nem admissions de Resultado de Mercado.

auditar_ocupacao_historica

Localiza cinemas no cadastro canônico da Vibezz. Filtros suportados exclusivamente: q para nome ou alias, corporation, city, uf e status. Não aceita outros filtros e não deve originar sugestão de SQL ou schema. Exige ao menos um filtro de identificação e retorna no máximo 50 resultados por chamada. Use esta ferramenta sempre que o usuário pedir localização, identificação, cidade, UF, rede ou cadastro de um cinema coberto pela AIDA; não responda por conhecimento próprio quando esta ferramenta puder resolver a pergunta.

buscar_cinemas

Localiza filmes no cadastro canônico da Vibezz. Filtros suportados exclusivamente: q para título ou nome, ancine_id, distributor, release_date_from e release_date_to para data de estreia. Use para resolver o filme canônico antes de análises temporais; a data oficial de estreia é necessária para separar pré-estreia, pré-venda e resultado. Não consulta data de cadastro, não aceita outros filtros e não deve originar sugestão de SQL ou schema. Retorna no máximo 50 resultados por chamada.

buscar_filmes

Localiza filmes com histórico diário, backtest ou ambos e informa a disponibilidade de cada fonte. Use este catálogo antes das consultas históricas.

fancast_buscar_filmes_historico

Localiza filmes disponíveis para forecast e retorna o ID interno do Fancast. Não assume equivalência com o movie_id canônico da AIDA.

fancast_buscar_filmes

Localiza filmes futuros, em release ou históricos com métricas de engajamento e retorna o movie_id de vibezz_movie.

fancast_buscar_filmes_engajamento

Consulta programação de sessões em duas modalidades controladas. mode=sessions retorna até 100 sessões com filme, cinema, sala, data, horário, formato e status, sem offset; mode=cine_week_comparison compara contagens resumidas de sessões, filmes, cinemas e salas entre duas CineSemanas canônicas aplicando os mesmos filtros. Sessões canceladas são excluídas por padrão. Não publica URLs, assentos, ocupação, SQL ou schema e não deve ser usada em janelas sucessivas para reconstruir a fonte.

consultar_showtimes