Como ler e exportar relatórios em PDF, CSV e JSON no Explory

A pesquisa só gera valor quando o insight chega na mesa certa — sócia, analista de pricing, agência ou planilha de forecast. Por isso, todo relatório concluído no Explory pode ser lido online no painel e exportado em formatos distintos, cada um com um uso prático.

Este guia explica onde encontrar os resultados e como baixar PDF, CSV e JSON sem perder dados.


Onde acessar relatórios concluídos

Há três caminhos principais:

1. Tela de resultado

Após a execução, você é direcionado ao progresso e, ao concluir, para /panel/research/{executionId}/result. Lá o relatório é renderizado com seções, gráficos e texto gerado pela IA.

2. Histórico de pesquisas

Em Histórico (/panel/research/history), veja todas as execuções — status, data, objetivo e plataforma. Clique em uma linha para abrir o detalhe (/panel/research/history/{executionId}) com metadados e atalhos de exportação.

3. Detalhe no histórico

O detalhe exibe objetivo, termos, plataforma, créditos consumidos e status. Se a execução falhou, exportações ficam indisponíveis; se concluiu, os botões de download aparecem no topo.


Formatos de exportação

| Formato | Melhor para | Disponibilidade | |---------|-------------|-----------------| | PDF | Apresentações, sócios, arquivo | Planos com canExportPdf | | CSV | Excel, Google Sheets, BI | Geralmente todos os planos ativos | | JSON | Integrações, automações, dev | Geralmente todos os planos ativos |

Verifique permissões em Conta → Perfil — a seção de plano lista se Exportação em PDF está habilitada.


Exportar na tela de resultado

Na página de resultado, role até o card Exportar relatório (componente dedicado no final da view). Três botões:

  1. PDF — gera documento formatado para leitura humana
  2. CSV — tabelas e métricas em colunas
  3. JSON — payload estruturado completo

Clique no formato desejado. Um spinner indica download em andamento; o arquivo é salvo pelo navegador com nome derivado da execução.

Se PDF estiver bloqueado, o botão não aparece ou exibe toast informando que o recurso não faz parte do seu plano — nesse caso, faça upgrade em /pricing.


Exportar pelo histórico

No detalhe da execução concluída, ícones compactos no cabeçalho permitem PDF, CSV e JSON sem abrir o relatório completo — útil quando você só precisa anexar o arquivo a um e-mail ou pipeline.

As mesmas regras de permissão se aplicam: PDF exige plano compatível.


Como usar cada formato na prática

PDF

  • Reunião de decisão go/no-go de produto
  • Enviar para investidor ou parceiro que não acessa o painel
  • Arquivar snapshot do momento da análise

CSV

  • Cruzar preço médio com custo de importação na planilha
  • Rankear termos por volume ou concorrência
  • Alimentar gráficos no Looker Studio ou Power BI

JSON

  • Script interno que compara execuções ao longo do tempo
  • Webhook ou ETL que ingere insights no CRM
  • Backup machine-readable do relatório

Boas práticas

  • Exporte logo após conclusão — especialmente se roda muitas pesquisas e pode perder o rastro no histórico.
  • Nomeie pastas por data e plataforma — facilita comparar Shopee vs. Amazon no fim do trimestre.
  • JSON para automação, PDF para humanos — evita converter manualmente tabelas.
  • Confira plano antes de projeto em equipe — se todos precisam de PDF, valide canExportPdf no upgrade.

Relatórios ainda processando

Enquanto status for "em progresso", exportações ficam ocultas. Acompanhe pela tela de progresso ou atualize o histórico. Notificações visuais no painel indicam conclusão ou falha.

Se créditos foram estornados após falha (creditsRefunded), rode nova execução com parâmetros ajustados antes de exportar.


Próximo passo

Relatório parado no painel ajuda só quem loga todo dia. Exportar em PDF, CSV ou JSON leva a inteligência de marketplace para onde sua operação realmente decide.

Conclua uma pesquisa e exporte seu primeiro relatório →